Skip to content

Commit 2356ef7

Browse files
authored
Fix the YUM and APT steps in APM server binary getting started (#1199)
[Docs ](https://www.elastic.co/docs/solutions/observability/apm/get-started-apm-server-binary#apm-setup-repositories)are showing 9.0.0beta1 not available messages. This PR updates the docs to manually add the steps and update versions.
1 parent b79b9a6 commit 2356ef7

File tree

1 file changed

+104
-5
lines changed

1 file changed

+104
-5
lines changed

solutions/observability/apm/get-started-apm-server-binary.md

Lines changed: 104 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -761,11 +761,83 @@ to sign all our packages. It is available from [https://pgp.mit.edu](https://pgp
761761
762762
### APT [_apt]
763763
764-
Version 9.0.0-beta1 of apm-server has not yet been released.
764+
To add the apm-server repository for APT:
765+
766+
1. Download and install the Public Signing Key:
767+
768+
```shell
769+
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
770+
```
771+
772+
1. You may need to install the `apt-transport-https` package on Debian before proceeding:
773+
774+
```shell
775+
sudo apt-get install apt-transport-https
776+
```
777+
778+
1. Save the repository definition to `/etc/apt/sources.list.d/elastic-9.0.0.list`:
779+
780+
```shell
781+
echo "deb https://artifacts.elastic.co/packages/9.0.0-prerelease/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-9.0.0-prerelease.list
782+
```
783+
784+
:::{warning}
785+
To add the Elastic repository, make sure that you use the `echo` method shown in the example. Do not use `add-apt-repository` because it will add a `deb-src` entry, but we do not provide a source package.
786+
787+
If you have added the `deb-src` entry by mistake, you will see an error like the following:
788+
789+
```text
790+
Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
791+
```
792+
:::
793+
794+
1. Run `apt-get update`, and the repository is ready for use. For example, you can install APM Server by running:
795+
796+
```shell
797+
sudo apt-get update && sudo apt-get install apm-server
798+
```
799+
800+
1. To configure APM Server to start automatically during boot, run:
801+
802+
```shell
803+
sudo systemctl enable apm-server
804+
```
765805
766806
### YUM [_yum]
767807
768-
Version 9.0.0-beta1 of apm-server has not yet been released.
808+
To add the apm-server repository for YUM:
809+
810+
1. Download and install the public signing key:
811+
812+
```shell
813+
sudo rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
814+
```
815+
816+
1. Create a file with a .repo extension (for example, elastic.repo) in your /etc/yum.repos.d/ directory and add the following lines:
817+
818+
```shell
819+
[elastic-9.0.0]
820+
name=Elastic repository for 9.0.0 packages
821+
baseurl=https://artifacts.elastic.co/packages/9.0.0/yum
822+
gpgcheck=1
823+
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
824+
enabled=1
825+
autorefresh=1
826+
type=rpm-md
827+
```
828+
829+
Your repository is ready to use. For example, you can install APM Server by running:
830+
831+
```shell
832+
sudo yum install apm-server
833+
```
834+
835+
1. To configure APM Server to start automatically during boot, run:
836+
837+
```shell
838+
sudo systemctl enable apm-server
839+
```
840+
769841
770842
## Run APM Server on Docker [apm-running-on-docker]
771843
@@ -779,7 +851,34 @@ These images are free to use under the Elastic license. They contain open source
779851
780852
Obtaining APM Server for Docker is as simple as issuing a `docker pull` command against the Elastic Docker registry and then, optionally, verifying the image.
781853
782-
However, version 9.0.0-beta1 of APM Server has not yet been released, so no Docker image is currently available for this version.
854+
1. Pull the Docker image:
855+
856+
```shell
857+
docker pull docker.elastic.co/apm/apm-server:9.0.0
858+
```
859+
860+
Alternately, you can use the hardened [Wolfi](https://wolfi.dev/) image:
861+
862+
```shell
863+
docker pull docker.elastic.co/apm/apm-server-wolfi:9.0.0
864+
```
865+
866+
1. Verify the Docker image:
867+
868+
```shell
869+
wget https://artifacts.elastic.co/cosign.pub
870+
cosign verify --key cosign.pub docker.elastic.co/apm/apm-server:9.0.0
871+
```
872+
873+
The `cosign` command prints the check results and the signature payload in JSON format:
874+
875+
```shell
876+
Verification for docker.elastic.co/apm/apm-server:9.0.0 --
877+
The following checks were performed on each of these signatures:
878+
- The cosign claims were validated
879+
- Existence of the claims in the transparency log was verified offline
880+
- The signatures were verified against the specified public key
881+
```
783882
784883
### Configure APM Server on Docker [_configure_apm_server_on_docker]
785884
@@ -803,7 +902,7 @@ docker run -d \
803902
--name=apm-server \
804903
--user=apm-server \
805904
--volume="$(pwd)/apm-server.docker.yml:/usr/share/apm-server/apm-server.yml:ro" \
806-
docker.elastic.co/apm/apm-server:9.0.0-beta1 \
905+
docker.elastic.co/apm/apm-server:9.0.0 \
807906
--strict.perms=false -e \
808907
-E output.elasticsearch.hosts=["elasticsearch:9200"] <1> <2>
809908
```
@@ -820,6 +919,6 @@ The `apm-server.docker.yml` downloaded earlier should be customized for your env
820919
It’s possible to embed your APM Server configuration in a custom image. Here is an example Dockerfile to achieve this:
821920
822921
```dockerfile
823-
FROM docker.elastic.co/apm/apm-server:9.0.0-beta1
922+
FROM docker.elastic.co/apm/apm-server:9.0.0
824923
COPY --chmod=0644 --chown=1000:1000 apm-server.yml /usr/share/apm-server/apm-server.yml
825924
```

0 commit comments

Comments
 (0)