docs: added archlinux install and distribution info

This commit is contained in:
max furman 2019-04-11 16:02:13 -07:00
parent c248b00c72
commit 81a50a26e4
2 changed files with 38 additions and 11 deletions

View file

@ -99,6 +99,8 @@ $ brew uninstall step
### Linux ### Linux
#### Debian
1. [Optional] Install `step cli`. 1. [Optional] Install `step cli`.
Download the latest Debian package from Download the latest Debian package from
@ -129,7 +131,17 @@ $ brew uninstall step
$ sudo dpkg -i step-certificates_X.Y.Z_amd64.deb $ sudo dpkg -i step-certificates_X.Y.Z_amd64.deb
``` ```
3. Test. #### Arch Linux
We are using the [Arch User Repository](https://aur.archlinux.org) to distribute
`step` binaries for Arch Linux.
* [Optional] The `step-cli` binary tarball can be found [here](https://aur.archlinux.org/packages/step-cli-bin/).
* The `step-ca` binary tarball can be found [here](https://aur.archlinux.org/packages/step-ca-bin/).
You can use [pacman](https://www.archlinux.org/pacman/) to install the packages.
### Test
<pre><code> <pre><code>
<b>$ step version</b> <b>$ step version</b>

View file

@ -27,8 +27,8 @@ e.g. `v1.0.2`
that all local changes have been pushed. that all local changes have been pushed.
``` ```
git pull --rebase origin master $ git pull --rebase origin master
git push $ git push
``` ```
3. **Tag it!** 3. **Tag it!**
@ -36,8 +36,8 @@ e.g. `v1.0.2`
1. **Find the most recent tag.** 1. **Find the most recent tag.**
``` ```
git fetch --tags $ git fetch --tags
git tag $ git tag
``` ```
The new tag needs to be the logical successor of the most recent existing tag. The new tag needs to be the logical successor of the most recent existing tag.
@ -65,17 +65,17 @@ e.g. `v1.0.2`
3. **Create a local tag.** 3. **Create a local tag.**
``` ```
git tag v1.0.3 # standard release $ git tag v1.0.3 # standard release
...or ...or
git tag v1.0.3-rc.1 # release candidate $ git tag v1.0.3-rc.1 # release candidate
``` ```
4. **Push the new tag to the remote origin.** 4. **Push the new tag to the remote origin.**
``` ```
git push origin tag v1.0.3 # standard release $ git push origin tag v1.0.3 # standard release
...or ...or
git push origin tag v1.0.3-rc.1 # release candidate $ git push origin tag v1.0.3-rc.1 # release candidate
``` ```
4. Check the build status at 4. Check the build status at
@ -93,9 +93,24 @@ e.g. `v1.0.2`
* **step-certificates_1.0.3_darwin_amd64.tar.gz**: tarball containing a statically compiled darwin binary. * **step-certificates_1.0.3_darwin_amd64.tar.gz**: tarball containing a statically compiled darwin binary.
* **step-certificates.tar.gz**: tarball containing a git archive of the full repo. * **step-certificates.tar.gz**: tarball containing a git archive of the full repo.
6. **Update the AUR Arch Linux package**
**NOTE**: if you plan to release `cli` next then you can skip this step.
```
$ cd archlinux
# Get up to date...
$ git pull origin master
$ make
$ ./update --ca v1.0.3
```
*All Done!* *All Done!*
## Versioning ## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, We use [SemVer](http://semver.org/) for versioning. See the
see the [tags on this repository](https://github.com/smallstep/certificates). [tags on this repository](https://github.com/smallstep/certificates) for all
available versions.