CZERTAINLY-Appliance-Tools

Debian package with czertainly appliance tools.

Content of etc/czertainly-ansible

Is created as git submodule.

First time initialization

cd CZERTAINLY-Appliance-Tools
git submodule add -b develop https://github.com/CZERTAINLY/ansible-role-czertainly-branding.git etc/czertainly-ansible/roles/branding
git submodule add -b develop https://github.com/CZERTAINLY/ansible-role-http-proxy.git etc/czertainly-ansible/roles/http-proxy
git submodule add -b develop https://github.com/CZERTAINLY/ansible-role-postgres.git etc/czertainly-ansible/roles/postgres
git submodule add -b develop https://github.com/CZERTAINLY/ansible-role-helm.git etc/czertainly-ansible/roles/helm
git submodule add -b develop https://github.com/CZERTAINLY/ansible-role-rke2.git etc/czertainly-ansible/roles/rke2
git submodule add -b develop https://github.com/CZERTAINLY/ansible-role-czertainly.git etc/czertainly-ansible/roles/czertainly

Update after checkout

cd CZERTAINLY-Appliance-Tools
git submodule update --init --recursive

Update after changes in submodules

cd CZERTAINLY-Appliance-Tools
git submodule foreach 'git pull origin; \
  git checkout develop; \
  git reset --hard origin/develop; \
  git submodule update --recursive; \
  git clean -dfx'

Change to your fork of submodule repository:

git submodule set-url -- etc/czertainly-ansible/roles/rke2 git@github.com:semik/ansible-role-rke2.git

Type exactly etc/czertainly-ansible/roles/rke2, not etc/czertainly-ansible/roles/rke2/ 😜

Check which files in /etc/czertainly-ansible/ have changed:

$ debsums -as czertainly-appliance-tools 2>&1 |grep -v '\/etc\/czertainly-ansible\/vars'
debsums: changed file /usr/bin/czertainly-tui (from czertainly-appliance-tools package)
debsums: changed file /etc/czertainly-ansible/roles/czertainly/tasks/main.yml (from czertainly-appliance-tools package)

The directory /etc/czertainly-ansible/vars is excluded because it is modified by user of the appliance.

Building package

./build-deb.sh

Final deb file is moved to current directory to be accessible in GitHub actions.

GitHub action configuration

Secrets

DEB_REPO_KEY - private key of the user on DEB_REPO_HOST

Repository Variables

DEB_REPO_HOST - hostname of host where repository is installed

DEB_REPO_USER - username of user used for publishing Debian package on DEB_REPO_HOST

DEB_REPO_DIRECTORY - directory where to put a new package (/var/www/deb.czertainly.com/incoming)

DEB_REPO_MANAGER - script used for managing debian repositoy (/var/www/deb.czertainly.com/manage-repository)