Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .github/actions/spelling/expect.txt
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@ badunit
bak
barfoo
barieom
basearch
baseof
basevalue
baskinc
Expand Down Expand Up @@ -449,6 +450,8 @@ gogoproto
goldberg
goldmark
GPB
gpgcheck
gpgkey
gqlgen
graphqlconfig
grault
Expand Down Expand Up @@ -574,6 +577,7 @@ kernelmode
keybase
keyclock
keyid
keyring
keyxxxxx
khvzak
kib
Expand Down Expand Up @@ -634,6 +638,7 @@ lukesteensen
macports
MAINPID
majorly
makecache
MAKECMDGOALS
Makefiles
markability
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,7 @@ Our APT repositories are provided by [Cloudsmith] and you can find [instructions
First, add the Vector repo:

```shell
curl -1sLf \
'https://repositories.timber.io/public/vector/cfg/setup/bash.deb.sh' \
| sudo -E bash
bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script_vector0.sh)"
```

Then you can install the `vector` package:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,25 +12,31 @@ weight: 2
curl \
--proto '=https' \
--tlsv1.2 -O \
https://packages.timber.io/vector/{{< version >}}/vector_{{< version >}}-1_amd64.deb
https://apt.vector.dev/pool/v/ve/vector_{{< version >}}-1_{arch}.deb

sudo dpkg -i vector_{{< version >}}-1_amd64.deb
sudo dpkg -i vector_{{< version >}}-1_{arch}.deb
```

Make sure to replace `{arch}` with one of the following:

* `amd64`
* `arm64`
* `armhf`

## Other actions

{{< tabs default="Upgrade Vector" >}}
{{< tab title="Upgrade Vector" >}}

```shell
dpkg -i vector-{{< version >}}-amd64
dpkg -i vector-{{< version >}}-{arch}
```

{{< /tab >}}
{{< tab title="Uninstall Vector" >}}

```shell
dpkg -r vector-{{< version >}}-amd64
dpkg -r vector-{{< version >}}-{arch}
```

{{< /tab >}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,14 @@ RPM Package Manager is a free and open source package management system for inst
## Installation

```shell
sudo rpm -i https://packages.timber.io/vector/{{< version >}}/vector-{{< version >}}-1.{arch}.rpm
sudo rpm -i https://yum.vector.dev/stable/vector-0/{arch}/vector-{{< version >}}-1.{arch}.rpm
```

Make sure to replace `{arch}` with one of the following:

* `x86_64`
* `aarch64`
* `armv7`
* `armv7hl`

## Other actions

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,7 @@ Our Yum repositories are provided by [Cloudsmith] and you can find [instructions
Add the repo:

```shell
curl -1sLf 'https://repositories.timber.io/public/vector/cfg/setup/bash.rpm.sh' \
| sudo -E bash
bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script_vector0.sh)"
```

Then you can install Vector:
Expand Down
124 changes: 124 additions & 0 deletions website/content/en/highlights/2023-11-07-new-linux-repos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
date: "2023-11-07"
title: "A New Home for Linux Packages"
description: ""
authors: ["spencergilbert"]
pr_numbers: []
release: "0.34.0"
hide_on_release_notes: false
badges:
type: "announcement"
---

Starting with Vector's `0.34.0` release, the `deb` and `rpm` packages will have
a new home at `vector.dev` courtesy of Datadog. We'll continue to publish
packages to both the new and existing locations through the end of **2023**.

{{< warning >}}
Starting in **2024**, we will stop using `timber.io` and exclusively publish packages
to `vector.dev`.
{{< /warning >}}

We aim to make this a seamless transition by providing plenty of time for you to switch
repositories, as well as by publishing previous versions of Vector with the new
repository as a drop-in replacement, so you don't have to update your Vector version.

If you have any questions or concerns don't hesitate to reach out on [Discord]
or [Discussions]!

## Migration guide

The following command **removes** the existing repository and configures the
new repository.

```sh
CSM_MIGRATE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script_vector0.sh)"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When running this script for the RPM installation, it prompted me when running yum install vector to accept the new keys. Is that expected? I somewhat expected this script to trust the keys already.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is because the Vector packages don't (yet?) depend on the signing keys packages which makes it a "separate" install? I know the deb's specify this explicitly, but I don't see where the rpm's do - maybe it's automagic?

@bkabrda do you know off the top of your head?

```

Alternatively, `CSM_MIGRATE` may be left unset to leave the removal of the
existing repository to your discretion.

### Manual step-by-step instructions

<details>
<summary>APT</summary>
1. Remove the existing repository:

```sh
rm "/etc/apt/sources.list.d/timber-vector.list"
```

2. Run the following commands to set up APT to download through HTTPS:

```sh
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
```

3. Run the following commands to set up the Vector `deb` repo on your system
and create a Datadog archive keyring:

```sh
echo "deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.vector.dev/ stable vector-0" | sudo tee "/etc/apt/sources.list.d/vector.list"
sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
sudo chmod a+r /usr/share/keyrings/datadog-archive-keyring.gpg
curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
```

4. Run the following commands to update your local `apt` repo and install Vector:

```sh
sudo apt-get update
sudo apt-get install vector
```

</details>

<details>
<summary>RPM</summary>

1. Remove the existing repository:

```sh
rm "/etc/yum.repos.d/timber-vector.repo"
```

2. Run the following commands to set up the Vector `rpm` repo on your system:

```sh
cat <<EOF > /etc/yum.repos.d/vector.repo
[vector]
name = Vector
baseurl = https://yum.vector.dev/stable/vector-0/\$basearch/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
EOF
```

**Note:** If you are running RHEL 8.1 or CentOS 8.1, use `repo_gpgcheck=0` instead of `repo_gpgcheck=1` in the configuration above.

3. Update your packages and install Vector:

```sh
sudo yum makecache
sudo yum install vector
```

</details>

### Notes

* While the existing packages were migrated without rebuilding them, the RPM
packages _were_ re-signed with a Datadog GPG key. This will cause checksums
to not match between equivalent packages from `vector.dev` and `timber.io`.
* Once packages are released only to `vector.dev`, APT packages will be signed
by a Datadog GPG key. This update will be announced in advance.

[Discord]: https://chat.vector.dev/
[Discussions]: https://discussions.vector.dev/