From 7390613fa113d33a7365be2126c6be7222851fdd Mon Sep 17 00:00:00 2001 From: Carl Tashian Date: Thu, 28 Sep 2023 15:36:41 -0700 Subject: [PATCH 1/3] Update install instructions with unversioned URLs --- step-ca/installation.mdx | 36 ++++++++++++++++++------------------ step-cli/installation.mdx | 22 +++++++++++----------- 2 files changed, 29 insertions(+), 29 deletions(-) diff --git a/step-ca/installation.mdx b/step-ca/installation.mdx index 6b370715..a730eae3 100644 --- a/step-ca/installation.mdx +++ b/step-ca/installation.mdx @@ -86,15 +86,15 @@ To uninstall, run `scoop uninstall`, then remove the configuration directory `$H To install `step`, download and install the Debian package for your platform from our [latest release](https://github.com/smallstep/cli/releases/latest): ```shell - wget https://dl.smallstep.com/gh-release/cli/docs-ca-install/v0.24.2/step-cli_0.24.2_amd64.deb - sudo dpkg -i step-cli_0.24.2_amd64.deb + wget https://dl.smallstep.com/cli/docs-ca-install/latest/step-cli_amd64.deb + sudo dpkg -i step-cli_amd64.deb ``` To install `step-ca`, download and install the Debian package for your platform from our [latest release](https://github.com/smallstep/certificates/releases/latest): ```shell - wget https://dl.smallstep.com/gh-release/certificates/docs-ca-install/v0.24.2/step-ca_0.24.2_amd64.deb - sudo dpkg -i step-ca_0.24.2_amd64.deb + wget https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_amd64.deb + sudo dpkg -i step-ca_amd64.deb ``` To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup]. @@ -124,15 +124,15 @@ Big shout out to the maintainers of these packages! We appreciate you. To install `step`, download and install the RPM package for your platform from our [latest release](https://github.com/smallstep/cli/releases/latest): ```shell - wget https://dl.smallstep.com/gh-release/cli/docs-ca-install/v0.24.2/step-cli_0.24.2_amd64.rpm - sudo dnf install step-cli_0.24.2_amd64.rpm + wget https://dl.smallstep.com/cli/docs-ca-install/latest/step-cli_amd64.rpm + sudo rpm -i step-cli_amd64.rpm ``` To install `step-ca`, download and install the RPM package for your platform from our [latest release](https://github.com/smallstep/certificates/releases/latest): ```shell - wget https://dl.smallstep.com/gh-release/certificates/docs-ca-install/v0.24.2/step-ca_0.24.2_amd64.rpm - sudo dnf install step-ca_0.24.2_amd64.rpm + wget https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_amd64.rpm + sudo rpm -i step-ca_amd64.rpm ``` To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup]. @@ -192,10 +192,10 @@ To download and install the `step` and `step-ca` binaries on an amd64 machine: Download and install the Linux tarball from our [latest release](https://github.com/smallstep/cli/releases/latest): ```shell - curl -L https://dl.smallstep.com/gh-release/cli/docs-ca-install/v0.24.2/step_linux_0.24.2_amd64.tar.gz \ - -o step.tar.gz + curl -L -o step.tar.gz https://dl.smallstep.com/cli/docs-ca-install/latest/step_linux_amd64.tar.gz tar -xf step.tar.gz - sudo cp step_0.24.2/bin/step /usr/bin + cd step_* + sudo cp bin/step /usr/bin ``` 2. Install `step-ca`. @@ -203,10 +203,10 @@ To download and install the `step` and `step-ca` binaries on an amd64 machine: Download and install the Linux tarball from our [latest release](https://github.com/smallstep/certificates/releases/latest): ```shell - curl -L https://dl.smallstep.com/gh-release/certificates/docs-ca-install/v0.24.2/step-ca_linux_0.24.2_amd64.tar.gz \ - -o step-ca.tar.gz + curl -L -o step-ca.tar.gz https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_linux_amd64.tar.gz tar -xf step-ca.tar.gz - sudo cp step-ca_0.24.2/step-ca /usr/bin + cd step-ca_* + sudo cp step-ca /usr/bin ``` To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup]. @@ -225,11 +225,11 @@ To verify the signature of the `step-ca` binary: ``` cosign verify-blob \ - --certificate step-ca_linux_0.24.2_amd64.tar.gz.pem \ - --signature step-ca_linux_0.24.2_amd64.tar.gz.sig \ - --certificate-identity-regexp "https://github\.com/smallstep/certificates/.*" \ + --certificate step-ca_linux_amd64.tar.gz.pem \ + --signature step-ca_linux_amd64.tar.gz.sig \ + --certificate-identity-regexp "https://github\.com/smallstep/workflows/.*" \ --certificate-oidc-issuer https://token.actions.githubusercontent.com \ - step-ca_linux_0.24.2_amd64.tar.gz + step-ca_linux_amd64.tar.gz ``` ### Kubernetes diff --git a/step-cli/installation.mdx b/step-cli/installation.mdx index b76bc274..257d2305 100644 --- a/step-cli/installation.mdx +++ b/step-cli/installation.mdx @@ -48,8 +48,8 @@ To uninstall, run `brew uninstall step` and remove the `$HOME/.step` configurati Download and install the Debian package from our [latest release](https://github.com/smallstep/cli/releases/latest): ```shell -wget https://dl.smallstep.com/gh-release/cli/docs-cli-install/v0.24.4/step-cli_0.24.4_amd64.deb -sudo dpkg -i step-cli_0.24.4_amd64.deb +wget https://dl.smallstep.com/cli/docs-cli-install/latest/step-cli_amd64.deb +sudo dpkg -i step-cli_amd64.deb ``` To uninstall, run `sudo dpkg -r step-cli` and remove the `$HOME/.step` configuration directory. @@ -80,8 +80,8 @@ Big shout out to the maintainers of these packages! We appreciate you. Download and install the RPM package from our [latest release](https://github.com/smallstep/cli/releases/latest): ```shell -wget https://dl.smallstep.com/gh-release/cli/docs-ca-install/v0.24.4/step-cli_0.24.4_amd64.rpm -sudo rpm -i step-cli_0.24.4_amd64.rpm +wget https://dl.smallstep.com/cli/docs-cli-install/latest/step-cli_amd64.rpm +sudo rpm -i step-cli_amd64.rpm ``` To uninstall, run `sudo dnf remove step-cli` and remove the `$HOME/.step` configuration directory. @@ -136,11 +136,11 @@ To verify the signature of the `step-ca` binary: ``` cosign verify-blob \ - --certificate step_linux_0.24.4_amd64.tar.gz.pem \ - --signature step_linux_0.24.4_amd64.tar.gz.sig \ - --certificate-identity-regexp "https://github\.com/smallstep/cli/.*" \ + --certificate step_linux_amd64.tar.gz.pem \ + --signature step_linux_amd64.tar.gz.sig \ + --certificate-identity-regexp "https://github\.com/smallstep/workflows/.*" \ --certificate-oidc-issuer https://token.actions.githubusercontent.com \ - step_linux_0.24.4_amd64.tar.gz + step_linux_amd64.tar.gz ``` ### Windows @@ -176,9 +176,9 @@ Download the Windows binary from our [latest releases](https://github.com/smalls Open PowerShell and run the following: ```shell -curl.exe -LO https://dl.smallstep.com/gh-release/cli/docs-cli-install/v0.24.4/step_windows_0.24.4_amd64.zip -Expand-Archive -LiteralPath .\step_windows_0.24.4_amd64.zip -DestinationPath . -step_0.24.4\bin\step.exe version +curl.exe -LO https://dl.smallstep.com/cli/docs-cli-install/latest/step_windows_amd64.zip +Expand-Archive -LiteralPath .\step_windows_amd64.zip -DestinationPath . +step_0.25.0\bin\step.exe version ``` Finally, move the `step.exe` binary wherever you'd like it to into a location in your user's `PATH`. From 31f6a7e1accbce7d8a5b4654f82ffb53c3a47389 Mon Sep 17 00:00:00 2001 From: Carl Tashian Date: Wed, 18 Oct 2023 12:11:24 -0700 Subject: [PATCH 2/3] Unversioned dir names --- step-ca/installation.mdx | 6 ++---- step-cli/installation.mdx | 2 +- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/step-ca/installation.mdx b/step-ca/installation.mdx index a730eae3..f0b23f0f 100644 --- a/step-ca/installation.mdx +++ b/step-ca/installation.mdx @@ -194,8 +194,7 @@ To download and install the `step` and `step-ca` binaries on an amd64 machine: ```shell curl -L -o step.tar.gz https://dl.smallstep.com/cli/docs-ca-install/latest/step_linux_amd64.tar.gz tar -xf step.tar.gz - cd step_* - sudo cp bin/step /usr/bin + sudo cp step/bin/step /usr/bin ``` 2. Install `step-ca`. @@ -205,8 +204,7 @@ To download and install the `step` and `step-ca` binaries on an amd64 machine: ```shell curl -L -o step-ca.tar.gz https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_linux_amd64.tar.gz tar -xf step-ca.tar.gz - cd step-ca_* - sudo cp step-ca /usr/bin + sudo cp step-ca/step-ca /usr/bin ``` To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup]. diff --git a/step-cli/installation.mdx b/step-cli/installation.mdx index 257d2305..7a0c8b4e 100644 --- a/step-cli/installation.mdx +++ b/step-cli/installation.mdx @@ -178,7 +178,7 @@ Open PowerShell and run the following: ```shell curl.exe -LO https://dl.smallstep.com/cli/docs-cli-install/latest/step_windows_amd64.zip Expand-Archive -LiteralPath .\step_windows_amd64.zip -DestinationPath . -step_0.25.0\bin\step.exe version +step\bin\step.exe version ``` Finally, move the `step.exe` binary wherever you'd like it to into a location in your user's `PATH`. From a8e1632338c2ce43c1311e6e34e92af88098c43a Mon Sep 17 00:00:00 2001 From: Carl Tashian Date: Wed, 29 Nov 2023 11:44:14 -0800 Subject: [PATCH 3/3] Couple tweaks --- step-ca/installation.mdx | 12 ++++++------ step-cli/installation.mdx | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/step-ca/installation.mdx b/step-ca/installation.mdx index f0b23f0f..a4143f30 100644 --- a/step-ca/installation.mdx +++ b/step-ca/installation.mdx @@ -192,9 +192,9 @@ To download and install the `step` and `step-ca` binaries on an amd64 machine: Download and install the Linux tarball from our [latest release](https://github.com/smallstep/cli/releases/latest): ```shell - curl -L -o step.tar.gz https://dl.smallstep.com/cli/docs-ca-install/latest/step_linux_amd64.tar.gz - tar -xf step.tar.gz - sudo cp step/bin/step /usr/bin + curl -LO https://dl.smallstep.com/cli/docs-ca-install/latest/step_linux_amd64.tar.gz + tar -xf step_linux_amd64.tar.gz + sudo cp step_linux_amd64/bin/step /usr/bin ``` 2. Install `step-ca`. @@ -202,9 +202,9 @@ To download and install the `step` and `step-ca` binaries on an amd64 machine: Download and install the Linux tarball from our [latest release](https://github.com/smallstep/certificates/releases/latest): ```shell - curl -L -o step-ca.tar.gz https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_linux_amd64.tar.gz - tar -xf step-ca.tar.gz - sudo cp step-ca/step-ca /usr/bin + curl -L https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_linux_amd64.tar.gz + tar -xf step-ca_linux_amd64.tar.gz + sudo cp step-ca_linux_amd64/step-ca /usr/bin ``` To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup]. diff --git a/step-cli/installation.mdx b/step-cli/installation.mdx index 7a0c8b4e..2d23dac3 100644 --- a/step-cli/installation.mdx +++ b/step-cli/installation.mdx @@ -178,7 +178,7 @@ Open PowerShell and run the following: ```shell curl.exe -LO https://dl.smallstep.com/cli/docs-cli-install/latest/step_windows_amd64.zip Expand-Archive -LiteralPath .\step_windows_amd64.zip -DestinationPath . -step\bin\step.exe version +step_windows_amd64\bin\step.exe version ``` Finally, move the `step.exe` binary wherever you'd like it to into a location in your user's `PATH`.