[CASSANDRA-19110] apt-key deprecation, replace with gpg --dearmor in the docs. - ASF JIRA

XML

Word

Printable

JSON

Details

Type: Improvement
Status: Resolved
Priority: Normal
Resolution: Fixed
Fix Version/s: 3.0.30, 3.11.17, 4.0.13, 4.1.5, 5.0-rc1, 5.0, 5.1
Component/s: Documentation/Website
Labels:
- pull-request-available

Change Category:
Semantic
Complexity:
Normal
Platform:

All
Impacts:

None
Source Control Link:

https://github.com/apache/cassandra-website/commit/443c2f3568e047fc33f363b7a719b2c151388995
Test and Documentation Plan:

Hide

doc change

Show
doc change

Description

the command `apt-key` is deprecated and soon to be removed, especially on Ubuntu.
the directory `/usr/share/keyrings` for shared keys are also being removed.

I suggest to convert the docs from

curl https://downloads.apache.org/cassandra/KEYS | sudo apt-key add -

to a simpler command:

curl https://downloads.apache.org/cassandra/KEYS | sudo gpg --dearmor -o /etc/apt/keyrings/cassandra-archive-keyring.gpg

The path `/etc/apt/keyrings` doesn't exists by default on Ubuntu 20.04 but it does on 22.04.

I also suggest to add the source.list.d text from

$ echo "deb https://debian.cassandra.apache.org 42x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list

deb https://debian.cassandra.apache.org 42x main

$ echo "deb [signed-by=/etc/apt/keyrings/cassandra-archive-keyring.gpg] https://debian.cassandra.apache.org 42x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list

deb [signed-by=/etc/apt/keyrings/cassandra-archive-keyring.gpg] https://debian.cassandra.apache.org 42x main

I have made a PR

I have tested the gpg --dearmor on a VM with Ubuntu 22.04 myself recently and it works just fine.