153 lines
5.3 KiB
Markdown
153 lines
5.3 KiB
Markdown
# Shell to Python Continuous Deployment
|
|
|
|
Get a common set of Python CI & CD commands \
|
|
from various contexts of CA, DNS, CI and OS / OCI.
|
|
|
|
## Features
|
|
|
|
Handle project workflows with any
|
|
* network infrastructure
|
|
* [X] online
|
|
* [X] offline with custom
|
|
* [X] Certificate Authorities
|
|
* [X] Domain Name System servers
|
|
* Continuous Integration platform
|
|
* [X] ForgeJo
|
|
* [X] Gitea
|
|
* [X] GitHub
|
|
* [X] GitLab
|
|
* [ ] SourceHut
|
|
* Operating System
|
|
* [X] Alma
|
|
* [X] 9
|
|
* [X] 8
|
|
* [X] Alpine
|
|
* [X] 3.20
|
|
* [X] 3.19
|
|
* [X] Arch
|
|
* [X] 20240818 (.0.255804)
|
|
* [X] 20240101 (.0.204074)
|
|
* [X] Debian
|
|
* [X] Bookworm (12)
|
|
* [ ] Bullseye (11)
|
|
* [X] Fedora
|
|
* [X] 40
|
|
* [X] 39
|
|
* [ ] OpenSUSE
|
|
* [ ] 15.6
|
|
* [ ] 15.5
|
|
* [X] Rocky
|
|
* [X] 9
|
|
* [X] 8
|
|
* [X] Ubuntu
|
|
* [X] Noble (24.04)
|
|
* [ ] Jammy (22.04)
|
|
|
|
## How
|
|
|
|
| Variable | Description | Default |
|
|
|:------------------|:-------------------------|:--------------------------------|
|
|
| SPCD_CA_n | Numbered CA certificates | |
|
|
| SPCD_CMD_SUM | Command to check sums | sha512sum |
|
|
| SPCD_DNS_n | Numbered name servers | 9.9.9.9 |
|
|
| SPCD_GIT_MAIN | Main Git repository | spcd |
|
|
| SPCD_GIT_ROOT | Root Git repository | rwx |
|
|
| SPCD_GIT_SHUNIT | ShUnit Git repository | shunit2 |
|
|
| SPCD_REF_FEATURE | Feature deployment ref | f |
|
|
| SPCD_REF_RELEASE | Release deployment ref | main |
|
|
| SPCD_REF_STAGING | Staging deployment ref | dev |
|
|
| 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_EPEL | EPEL repository URL | https://dl.fedoraproject.org |
|
|
| SPCD_URL_FEDORA | Fedora repository URL | https://rpmfind.net |
|
|
| SPCD_URL_OPENSUSE | OpenSUSE repository URL | https://download.opensuse.org |
|
|
| SPCD_URL_PYTHON | Python repository URL | https://pypi.org/simple |
|
|
| SPCD_URL_ROCKY | Rocky repository URL | https://dl.rockylinux.org |
|
|
| SPCD_URL_UBUNTU | Ubuntu repository URL | https://ubuntu.mirrors.ovh.net |
|
|
|
|
## Packages
|
|
|
|
### Latest
|
|
|
|
| os | https | updt-ca | python | graphviz | plantuml | shellcheck | shunit | shfmt |
|
|
|:----------------|---|---|------------:|------:|-----------:|------:|------:|-----:|
|
|
| Arch 20240818 | ☑ | ☑ | 3.12 | 12.0 | 1.2023.13 | 0.10 | 2.1.8 | 3.8 |
|
|
| Alpine 3.20 | ☑ | ☐ | 3.12 | 9.0 | 1.2024.4 | 0.10 | 2.1.8 | 3.8 |
|
|
| Fedora 40 | ☑ | ☑ | 3.12 → 3.13 | 9.0 | 1.2024.6 | 0.9 | 2.1.6 | 3.7 |
|
|
| Debian Bookworm | ☐ | ☐ | 3.11 | 2.42 | 1.2020.2 | 0.9 | 2.1.8 | 3.6 |
|
|
| OpenSUSE 15.6 | ☐ | ☑ | 3.6 → 3.12 | 2.48 | 1.2020.9 | 0.8 | 2.1.6 | 3.5 |
|
|
| Ubuntu Noble | ☐ | ☐ | 3.12 | u2.42 | u1.2020.2 | u0.9 | 2.1.8 | u3.8 |
|
|
| Alma / Rocky 9 | ☑ | ☑ | 3.9 → 3.12 | 2.44 | e1.2024.6 | e0.8 | git | |
|
|
|
|
### Previous
|
|
|
|
| os | https | updt-ca | python | graphviz | plantuml | shellcheck | shunit | shfmt |
|
|
|:----------------|---|---|------------:|------:|-----------:|------:|------:|-----:|
|
|
| Alpine 3.19 | ☑ | ☐ | 3.11 | 9.0 | 1.2023.12 | 0.9 | 2.1.8 | 3.7 |
|
|
| Fedora 39 | ☑ | ☑ | 3.12 → 3.13 | 8.1 | 1.2024.6 | 0.9 | 2.1.6 | 3.5 |
|
|
| OpenSUSE 15.5 | ☐ | ☑ | 3.6 → 3.11 | 2.48 | 1.2020.9 | 0.8 | 2.1.6 | 3.5 |
|
|
| Alma / Rocky 8 | ☑ | ☑ | 3.6 → 3.12 | 2.40 | e1.2024.6 | e0.6 | git | |
|
|
|
|
### Older Python
|
|
|
|
| os | https | updt-ca | python | graphviz | plantuml | shellcheck | shunit | shfmt |
|
|
|:----------------|---|---|------------:|------:|-----------:|------:|------:|-----:|
|
|
| Ubuntu Jammy | ☐ | ☐ | 3.10 | u2.42 | u1.2020.2 | u0.8 | 2.1.6 | u3.4 |
|
|
| Debian Bullseye | ☐ | ☐ | 3.9 | 2.42 | 1.2020.2 | 0.7 | 2.1.6 | |
|
|
|
|
## Tasks
|
|
|
|
* try git repo url variable first for shunit
|
|
|
|
### Shell
|
|
|
|
* fit banner to text
|
|
* review repositories handling for systems
|
|
* opensuse
|
|
* codecs repository
|
|
* disable & enable https
|
|
* write function to clone git repositories
|
|
* write unit tests
|
|
|
|
### Shell → Python
|
|
|
|
* check file & variable sums
|
|
* install system packages
|
|
* epel
|
|
* plantuml
|
|
* shellcheck
|
|
* graphviz
|
|
* openssh
|
|
* rsync
|
|
* shfmt
|
|
* shunit
|
|
* python virtual environment
|
|
* install system package
|
|
* configure pip
|
|
* venv
|
|
* create
|
|
* activate
|
|
* relay environment module name
|
|
|
|
### Python
|
|
|
|
* check
|
|
* .py
|
|
* .sh
|
|
* maximum line length
|
|
* detect ssh private key type
|
|
* fit banner to text
|
|
* implement substeps
|
|
* list sys.path
|
|
* set workflow templates
|
|
* actions
|
|
* includes
|
|
* write unit tests
|
|
|
|
### Later
|
|
|
|
* turn readme into documentation
|