Reading the repo
Reading the repo
Assembly instructions
Learn cloud security by building it! An open-source homelab teaching Zero Trust, DevSecOps, IaC, and cloud architecture from the ground up.
Saved setup from 7 h ago
Will it work on macOS?
Install OpenTofu 1.8 or newer, Python 3 and, for the policy tests, OPA 1.21.0, then:
# cost gate: totals the planned resources and compares with docs/stages/approved.json
python3 -I scripts/cost_check.py --root .
# the settings page must match docs/settings.json
python3 -I scripts/gen_settings_doc.py --check
python3 -I scripts/gen_project_status.py --check
# the repository tests (needs a virtualenv with pytest and pyyaml installed)
python3 -I -m pytest tests -q
# no cloud account ids in tracked files
python3 -I scripts/identifier_check.py --root .
# tests for the Spacelift push policy
opa test .spacelift/policies -v
# tests for one module or stack (no cloud account needed, providers are mocked)
tofu -chdir=modules/firewall init -backend=false
tofu -chdir=modules/firewall test
Run the last pair for each directory in the directories list of the tofu job in .github/workflows/ci.yml: modules/vpc, modules/firewall, modules/twingate-bootstrap, modules/twingate-connector, modules/edge-host, modules/docker-host, modules/spaces-bucket, modules/aws/vpc, modules/aws/firewall, modules/aws/twingate-connector, stacks/00-foundation, stacks/10-access, stacks/20-telemetry, stacks/30-workloads, stacks/50-edge, stacks/aws/00-foundation and stacks/aws/10-access. CI runs all of it through git-your-ship-together's shared workflows; the only job this repository defines itself is the CI green gate.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/ChiefGyk3D/Clouds-Against-Humanity.git cd Clouds-Against-Humanity
Python 3
brew install python
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
python3 -I scripts/cost_check.py --root . python3 -I scripts/gen_settings_doc.py --check python3 -I scripts/gen_project_status.py --check python3 -I -m pytest tests -q python3 -I scripts/identifier_check.py --root . opa test .spacelift/policies -v tofu -chdir=modules/firewall init -backend=false tofu -chdir=modules/firewall test
No reports for macOS yet.
Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.