diff --git a/README.md b/README.md index 673b741..e3764f4 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,35 @@ This includes tasks such as installation, running, stopping, etc. ## Installation +### Install From APT (Debian/Ubuntu) + +1. Update the `apt` package index and install packages needed to use the fioup `apt` repository: + + ``` + sudo apt update + sudo apt install -y apt-transport-https ca-certificates curl gnupg + ``` + +1. Download the public signing key for the package repositories: + + ``` + curl -L https://fioup.foundries.io/pkg/deb/dists/stable/Release.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/fioup-stable.gpg + ``` + +1. Add the appropriate `apt` repository. + + ``` + echo 'deb [signed-by=/etc/apt/trusted.gpg.d/fioup-stable.gpg] https://fioup.foundries.io/pkg/deb stable main' | sudo tee /etc/apt/sources.list.d/fioup.list + ``` + +1. Install composectl + + ``` + sudo apt update && sudo apt install composectl + ``` + +### Install The Development Version (from source) + ```commandline git clone https://github.com/foundriesio/composeapp.git ``` diff --git a/RELEASING.md b/RELEASING.md index 52b5667..883502a 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -64,4 +64,20 @@ git push origin v1.1.0 This triggers GitHub Actions to build artifacts and create the GitHub Release: * Linux binaries for amd64 and arm64. -* Debian artifacts (`"deb"`) for amd64 and arm64. \ No newline at end of file +* Debian artifacts (`"deb"`) for amd64 and arm64. + +### Publish Debian Packages to Archive + +Assume we are releasing v1.1.0 + +``` + mkdir /tmp/archive + ./debian/release-prep-archive.sh /tmp/archive 1.1.0 + ./debian/release-publish-archive.sh / /tmp/archive +``` + +As a sanity check run `find /tmp/archive` then push to the archive with: + +``` + gsutil rsync -r /tmp/archive/ gs://fioup.foundries.io/ +```