Repositories

DOWNLOAD.md

@@ -1,90 +1,194 @@
 ### Latest stable release downloads 
-#### Latest stable build is v1.1.1
 
-Here you can find links to latest binary packages for all supported operating systems.
+Here you can find instructions on how to setup latest binary packages for all supported operating systems.
+
+Binary package repositories for Kafe are generously hosted by [Cloudsmith](https://cloudsmith.io).
 
-- [CentOS and RHEL 7](#centos-and-rhel-7)
-- [CentOS and RHEL 8](#centos-and-rhel-8)
 - [Debian 9](#debian-9)
 - [Debian 10](#debian-10)
 - [Debian 11](#debian-11)
-- [Fedora 31](#fedora-31)
-- [Fedora 32](#fedora-32)
-- [Fedora 33](#fedora-33)
 - [Ubuntu 18.04](#ubuntu-1804)
 - [Ubuntu 19.10](#ubuntu-1910)
 - [Ubuntu 20.04](#ubuntu-2004)
 - [Ubuntu 20.10](#ubuntu-2010)
+- [CentOS and RHEL 7](#centos-and-rhel-7)
+- [CentOS and RHEL 8](#centos-and-rhel-8)
+- [Fedora 31](#fedora-31)
+- [Fedora 32](#fedora-32)
+- [Fedora 33](#fedora-33)
+
+See [releases](https://github.com/libkafe/kafe/releases) for all available downloads and historic versions,
+including development headers.
 
 *NOTE:* macOS is supported, but there are no binary builds available. See [README](./README.md#building-on-macos)
 on how to build macOS binaries from source.
 
 *NOTE:* You should be able to use these binary packages for any derivative distributions too. For example, 
 Elementary OS 5.1 users can use Ubuntu 18.04 packages, since Elementary OS 5.1 is based on Ubuntu 18.04.
 
-See [releases](https://github.com/libkafe/kafe/releases) for all available downloads and historic versions,
-including development headers.
+**IMPORTANT:** snippets bellow assume for commands listed to be executed as root.
 
-#### CentOS and RHEL 7
+#### Debian 9
 
-- [kafe-cli-1.1.1-1.x86_64.el7.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli-1.1.1-1.x86_64.el7.rpm)
-- [libkafe-1.1.1-1.x86_64.el7.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe-1.1.1-1.x86_64.el7.rpm)
+```shell script
+# Install APT dependencies
+apt update && apt-get install -y apt-transport-https gnupg
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/debian stretch main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-**IMPORTANT:** Kafe requires Lua version 5.3, a dependency not available in EL7 by default. You can either
-build the package yourself or use [Cheese](http://www.nosuchhost.net/~cheese/fedora/packages/epel-7/x86_64/cheese-release.html)
-repository to obtain compatible Lua package.
+#### Debian 10
 
-#### CentOS and RHEL 8
+```shell script
+# Install APT dependencies
+apt update && apt-get install -y apt-transport-https
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/debian buster main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-- [kafe-cli-1.1.1-1.x86_64.el8.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli-1.1.1-1.x86_64.el8.rpm)
-- [libkafe-1.1.1-1.x86_64.el8.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe-1.1.1-1.x86_64.el8.rpm)
+#### Debian 11
 
-#### Debian 9
+```shell script
+# Install APT dependencies
+apt update && apt-get install -y apt-transport-https
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/debian bullseye main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-- [kafe-cli_1.1.1_amd64.deb9.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.deb9.deb)
-- [libkafe_1.1.1_amd64.deb9.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.deb9.deb)
+#### Ubuntu 18.04
 
-#### Debian 10
+```shell script
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/ubuntu bionic main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-- [kafe-cli_1.1.1_amd64.deb10.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.deb10.deb)
-- [libkafe_1.1.1_amd64.deb10.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.deb10.deb)
+#### Ubuntu 19.10
 
-#### Debian 11
+```shell script
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/ubuntu eoan main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-- [kafe-cli_1.1.1_amd64.deb11.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.deb11.deb)
-- [libkafe_1.1.1_amd64.deb11.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.deb11.deb)
+#### Ubuntu 20.04
 
-#### Fedora 31
+```shell script
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/ubuntu focal main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-- [kafe-cli-1.1.1-1.x86_64.f31.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli-1.1.1-1.x86_64.f31.rpm)
-- [libkafe-1.1.1-1.x86_64.f31.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe-1.1.1-1.x86_64.f31.rpm)
+#### Ubuntu 20.10
 
-#### Fedora 32
+```shell script
+# Setup Kafe repository signing key
+apt-key adv --keyserver keyserver.ubuntu.com --recv AEE35447B5D3E4A69860622702F762CA6730E6A7
+# Setup repository
+echo 'deb https://dl.cloudsmith.io/public/kafe/libkafe/deb/ubuntu groovy main' | \
+  tee /etc/apt/sources.list.d/kafe.list
+# Update APT package lists and install kafe-cli
+apt update && apt -y install kafe-cli
+# Print about
+kafe about
+```
 
-- [kafe-cli-1.1.1-1.x86_64.f32.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli-1.1.1-1.x86_64.f32.rpm)
-- [libkafe-1.1.1-1.x86_64.f32.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe-1.1.1-1.x86_64.f32.rpm)
+#### CentOS and RHEL 7
 
-#### Fedora 33
+**IMPORTANT:** Kafe requires Lua version 5.3, a dependency not available in EL7 by default. You can either
+build the package yourself or use [Cheese](http://www.nosuchhost.net/~cheese/fedora/packages/epel-7/x86_64/cheese-release.html)
+repository to obtain compatible Lua package.
 
-- [kafe-cli-1.1.1-1.x86_64.f33.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli-1.1.1-1.x86_64.f33.rpm)
-- [libkafe-1.1.1-1.x86_64.f33.rpm](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe-1.1.1-1.x86_64.f33.rpm)
+```shell script
+# Setup cheese repository (Lua 5.3)
+rpm -i http://www.nosuchhost.net/~cheese/fedora/packages/epel-7/x86_64/cheese-release-7-1.noarch.rpm
+# Setup repository
+curl -1sLf 'https://dl.cloudsmith.io/public/kafe/libkafe/cfg/setup/bash.rpm.sh' | distro=el codename=7 bash
+# Install kafe-cli
+yum -y install kafe-cli
+# Print about
+kafe about
+```
 
-#### Ubuntu 18.04
+#### CentOS and RHEL 8
 
-- [kafe-cli_1.1.1_amd64.ubu1804.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.ubu1804.deb)
-- [libkafe_1.1.1_amd64.ubu1804.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.ubu1804.deb)
+```shell script
+# Setup repository
+curl -1sLf 'https://dl.cloudsmith.io/public/kafe/libkafe/cfg/setup/bash.rpm.sh' | distro=el codename=8 bash
+# Install kafe-cli
+dnf install -y kafe-cli 
+# Print about
+kafe about
+```
 
-#### Ubuntu 19.10
+#### Fedora 31
 
-- [kafe-cli_1.1.1_amd64.ubu1910.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.ubu1910.deb)
-- [libkafe_1.1.1_amd64.ubu1910.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.ubu1910.deb)
+```shell script
+# Setup repository
+curl -1sLf 'https://dl.cloudsmith.io/public/kafe/libkafe/cfg/setup/bash.rpm.sh' | distro=fedora codename=31 bash
+# Install kafe-cli
+dnf install -y kafe-cli 
+# Print about
+kafe about
+```
 
-#### Ubuntu 20.04
+#### Fedora 32
 
-- [kafe-cli_1.1.1_amd64.ubu2004.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.ubu2004.deb)
-- [libkafe_1.1.1_amd64.ubu2004.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.ubu2004.deb)
+```shell script
+# Setup repository
+curl -1sLf 'https://dl.cloudsmith.io/public/kafe/libkafe/cfg/setup/bash.rpm.sh' | distro=fedora codename=32 bash
+# Install kafe-cli
+dnf install -y kafe-cli 
+# Print about
+kafe about
+```
 
-#### Ubuntu 20.10
+#### Fedora 33
 
-- [kafe-cli_1.1.1_amd64.ubu2010.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/kafe-cli_1.1.1_amd64.ubu2010.deb)
-- [libkafe_1.1.1_amd64.ubu2010.deb](https://github.com/libkafe/kafe/releases/download/v1.1.1/libkafe_1.1.1_amd64.ubu2010.deb)
+```shell script
+# Setup repository
+curl -1sLf 'https://dl.cloudsmith.io/public/kafe/libkafe/cfg/setup/bash.rpm.sh' | distro=fedora codename=33 bash
+# Install kafe-cli
+dnf install -y kafe-cli 
+# Print about
+kafe about
+```

README.md

@@ -2,10 +2,9 @@ Kafe (`/ka'fe:/`) is an open source scriptable systems automation toolkit. It pr
 with local and remote systems over SSH. Kafe is well suited for application deployment and similar 
 remote systems administration tasks.
 
-## Downloads
+## Installation
 
-See [available binary packages](DOWNLOAD.md) for current stable release or [releases](https://github.com/libkafe/kafe/releases) for 
-all available downloads and historic versions.
+See [available package downloads and repositories](DOWNLOAD.md).
 
 Binary builds are available for:
 
@@ -15,7 +14,7 @@ Binary builds are available for:
 - **Debian** versions [9](./DOWNLOAD.md#debian-9), [10](./DOWNLOAD.md#debian-10), [11](./DOWNLOAD.md#debian-11)
 
 You should be able to use these binary packages for any derivative distributions.
-For example, Elementary OS 5.1 users can use Ubuntu 18.04 packages, since Elementary OS is based on Ubuntu 18.04.
+For example, Elementary OS 5.1 users can use Ubuntu 18.04 packages, since Elementary OS 5.1 is based on Ubuntu 18.04.
 
 **macOS is officially supported**, but binary builds are not provided. See bellow how to compile 
 Kafe from source - building Kafe on macOS is fairly trivial.
@@ -237,11 +236,6 @@ If you would like to contribute your distribution to the above list, you can imp
 Just follow the samples already present in [dist](./dist) folder. Any contributions adding support for
 new distributions must contain all current non-EOL distribution versions, including RC versions, if any.
 
-#### Does Kafe have APT / YUM repositories?
-
-Not at the moment. Having repositories for CentOS, RHEL, Fedora, Debian and Ubuntu is something that I plan
-to do in the future.
-
 #### Is Kafe available on Homebrew?
 
 No, but it is planned.

publish.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+
+# EL
+cloudsmith push rpm kafe/libkafe/el/7 build-artifact/centos-7/kafe-cli-1.1.1-1.x86_64.el7.rpm
+cloudsmith push rpm kafe/libkafe/el/7 build-artifact/centos-7/libkafe-1.1.1-1.x86_64.el7.rpm
+cloudsmith push rpm kafe/libkafe/el/7 build-artifact/centos-7/libkafe-devel-1.1.1-1.x86_64.el7.rpm
+
+cloudsmith push rpm kafe/libkafe/el/8 build-artifact/centos-8/kafe-cli-1.1.1-1.x86_64.el8.rpm
+cloudsmith push rpm kafe/libkafe/el/8 build-artifact/centos-8/libkafe-1.1.1-1.x86_64.el8.rpm
+cloudsmith push rpm kafe/libkafe/el/8 build-artifact/centos-8/libkafe-devel-1.1.1-1.x86_64.el8.rpm
+
+# Debian
+cloudsmith push deb kafe/libkafe/debian/stretch build-artifact/debian-9/kafe-cli_1.1.1_amd64.deb9.deb
+cloudsmith push deb kafe/libkafe/debian/stretch build-artifact/debian-9/libkafe_1.1.1_amd64.deb9.deb
+cloudsmith push deb kafe/libkafe/debian/stretch build-artifact/debian-9/libkafe-dev_1.1.1_amd64.deb9.deb
+
+cloudsmith push deb kafe/libkafe/debian/buster build-artifact/debian-10/kafe-cli_1.1.1_amd64.deb10.deb
+cloudsmith push deb kafe/libkafe/debian/buster build-artifact/debian-10/libkafe_1.1.1_amd64.deb10.deb
+cloudsmith push deb kafe/libkafe/debian/buster build-artifact/debian-10/libkafe-dev_1.1.1_amd64.deb10.deb
+
+cloudsmith push deb kafe/libkafe/debian/bullseye build-artifact/debian-11/kafe-cli_1.1.1_amd64.deb11.deb
+cloudsmith push deb kafe/libkafe/debian/bullseye build-artifact/debian-11/libkafe_1.1.1_amd64.deb11.deb
+cloudsmith push deb kafe/libkafe/debian/bullseye build-artifact/debian-11/libkafe-dev_1.1.1_amd64.deb11.deb
+
+# Ubuntu
+cloudsmith push deb kafe/libkafe/ubuntu/bionic build-artifact/ubuntu-1804/kafe-cli_1.1.1_amd64.ubu1804.deb
+cloudsmith push deb kafe/libkafe/ubuntu/bionic build-artifact/ubuntu-1804/libkafe_1.1.1_amd64.ubu1804.deb
+cloudsmith push deb kafe/libkafe/ubuntu/bionic build-artifact/ubuntu-1804/libkafe-dev_1.1.1_amd64.ubu1804.deb
+
+cloudsmith push deb kafe/libkafe/ubuntu/eoan build-artifact/ubuntu-1910/kafe-cli_1.1.1_amd64.ubu1910.deb
+cloudsmith push deb kafe/libkafe/ubuntu/eoan build-artifact/ubuntu-1910/libkafe_1.1.1_amd64.ubu1910.deb
+cloudsmith push deb kafe/libkafe/ubuntu/eoan build-artifact/ubuntu-1910/libkafe-dev_1.1.1_amd64.ubu1910.deb
+
+cloudsmith push deb kafe/libkafe/ubuntu/focal build-artifact/ubuntu-2004/kafe-cli_1.1.1_amd64.ubu2004.deb
+cloudsmith push deb kafe/libkafe/ubuntu/focal build-artifact/ubuntu-2004/libkafe_1.1.1_amd64.ubu2004.deb
+cloudsmith push deb kafe/libkafe/ubuntu/focal build-artifact/ubuntu-2004/libkafe-dev_1.1.1_amd64.ubu2004.deb
+
+cloudsmith push deb kafe/libkafe/ubuntu/groovy build-artifact/ubuntu-2010/kafe-cli_1.1.1_amd64.ubu2010.deb
+cloudsmith push deb kafe/libkafe/ubuntu/groovy build-artifact/ubuntu-2010/libkafe_1.1.1_amd64.ubu2010.deb
+cloudsmith push deb kafe/libkafe/ubuntu/groovy build-artifact/ubuntu-2010/libkafe-dev_1.1.1_amd64.ubu2010.deb
+
+# Fedora
+cloudsmith push rpm kafe/libkafe/fedora/31 build-artifact/fedora-31/kafe-cli-1.1.1-1.x86_64.f31.rpm
+cloudsmith push rpm kafe/libkafe/fedora/31 build-artifact/fedora-31/libkafe-1.1.1-1.x86_64.f31.rpm
+cloudsmith push rpm kafe/libkafe/fedora/31 build-artifact/fedora-31/libkafe-devel-1.1.1-1.x86_64.f31.rpm
+
+cloudsmith push rpm kafe/libkafe/fedora/32 build-artifact/fedora-32/kafe-cli-1.1.1-1.x86_64.f32.rpm
+cloudsmith push rpm kafe/libkafe/fedora/32 build-artifact/fedora-32/libkafe-1.1.1-1.x86_64.f32.rpm
+cloudsmith push rpm kafe/libkafe/fedora/32 build-artifact/fedora-32/libkafe-devel-1.1.1-1.x86_64.f32.rpm
+
+cloudsmith push rpm kafe/libkafe/fedora/33 build-artifact/fedora-33/kafe-cli-1.1.1-1.x86_64.f33.rpm
+cloudsmith push rpm kafe/libkafe/fedora/33 build-artifact/fedora-33/libkafe-1.1.1-1.x86_64.f33.rpm
+cloudsmith push rpm kafe/libkafe/fedora/33 build-artifact/fedora-33/libkafe-devel-1.1.1-1.x86_64.f33.rpm