spcd/readme.md

# Shell to Python Continuous Deployment

Get a common set of Python CI & CD commands \
from various contexts of CA, CI and OCI / OS.

## Features

* Certification Authority certificates
  * [X] custom
  * [X] known
* Continuous Integration platforms
  * [X] ForgeJo
  * [X] Gitea
  * [X] GitHub
  * [X] GitLab
  * [ ] SourceHut
* Operating Systems
  * [X] Alma → Python 3.11
    * [X] 9
    * [X] 8
  * [X] Alpine
    * [X] 3.20 → Python 3.12
    * [X] 3.19 → Python 3.11
  * [X] Arch → Python 3.12
    * [X] 20240101
    * [ ] 20231112
  * [X] Debian
    * [X] Bookworm (12) → Python 3.11
    * [ ] Bullseye (11) → Python 3.9
  * [X] Fedora → Python 3.12
    * [X] 40
    * [X] 39
  * [X] Rocky → Python 3.11
    * [X] 9
    * [X] 8
  * [X] Ubuntu
    * [X] Noble (24.04) → Python 3.12
    * [X] Jammy (22.04) → Python 3.10

## How

| Variable            | Description               | Default                         |
|:--------------------|:--------------------------|:--------------------------------|
| SPCD_BRANCH_RELEASE | Release deployment branch | main                            |
| SPCD_BRANCH_STAGING | Staging deployment branch | dev                             |
| SPCD_BRANCH_FEATURE | Feature deployment branch | f                               |
| SPCD_CA_n           | Numbered CA certificate   |                                 |
| SPCD_DNS            | Space separated servers   | 9.9.9.9                         |
| SPCD_GIT_MAIN       | Main Git repository       | spcd                            |
| SPCD_GIT_ROOT       | Root Git repository       | rwx                             |
| SPCD_SSH_HOSTS      | domain.tld ssh-type pub   |                                 |
| SPCD_SSH_KEY        | SSH private key           |                                 |
| SPCD_URL_ALMA       | Alma repository URL       | https://repo.almalinux.org      |
| SPCD_URL_ALPINE     | Alpine repository URL     | https://dl-cdn.alpinelinux.org  |
| SPCD_URL_ARCH       | Arch repository URL       | https://geo.mirror.pkgbuild.com |
| SPCD_URL_DEBIAN     | Debian repository URL     | https://deb.debian.org          |
| SPCD_URL_FEDORA     | Fedora repository URL     | https://rpmfind.net             |
| SPCD_URL_ROCKY      | Rocky repository URL      | https://dl.rockylinux.org       |
| SPCD_URL_UBUNTU     | Ubuntu repository URL     | https://ubuntu.mirrors.ovh.net  |

## HTTPS & Python

| OS img  | crt | upd | Python |
|:--------|-----|-----|:-------|
| Alma 8  | ☑   | ☑   | ☐      |
| Alma 9  | ☑   | ☑   | ☑ 3.9  |
| Alpine  | ☑   | ☐   | ☐      |
| Arch    | ☑   | ☑   | ☐      |
| Debian  | ☐   | ☐   | ☐      |
| Fedora  | ☑   | ☑   | ☑ 3.12 |
| Rocky 8 | ☑   | ☑   | ☐      |
| Rocky 9 | ☑   | ☑   | ☑ 3.9  |
| Ubuntu  | ☐   | ☐   | ☐      |

## Tasks

* relay environment module name
* write tests

### .py

* detect ssh private key type
* implement project repository cloning
* install
  * epel
    * plantuml
    * shellcheck
  * graphviz
  * openssh
  * pip
    * ruff
  * rsync
  * shfmt
* lint
  * .py
  * .sh

### .sh

* support opensuse