farscapian/sovereign-stack
1
0
Fork 0
forked from ss/sovereign-stack
Code Pull Requests Releases Activity
This is farscapian's working Sovereign Stack fork. This is the most up-to-date version of Sovereign Stack. https://www.sovereign-stack.org
82 Commits 1 Branch 11 Tags 1.4 MiB
Shell 100%
e5164ebc7e
Go to file
Derek Smith e5164ebc7e
Before removing AWS functionality.
2022-10-30 22:09:44 -04:00
.vscode Whitespace, formatting, control udpates. 2022-08-15 09:37:13 -04:00
certs Moved files 2022-05-24 14:14:53 -04:00
deployment Before removing AWS functionality. 2022-10-30 22:09:44 -04:00
management Huge updates. 2022-07-27 12:38:33 -04:00
staging Huge updates. 2022-07-27 12:38:33 -04:00
.gitignore Various refactors. Separting out VMs. 2022-08-24 10:11:50 -04:00
51-trezor.rules Initial Commit 2021-12-25 13:43:01 -05:00
cluster.sh Before removing AWS functionality. 2022-10-30 22:09:44 -04:00
defaults.sh Minor formatting and stability updates. 2022-10-30 12:59:24 -04:00
deploy.sh Minor formatting and stability updates. 2022-10-30 12:59:24 -04:00
domain_env.sh Suppress error messages and timing. 2022-10-29 11:34:17 -04:00
install.sh Suppress error messages and timing. 2022-10-29 11:34:17 -04:00
migrate.sh Before removing AWS functionality. 2022-10-30 22:09:44 -04:00
NOTES Multilanguage ghost and other updates. 2022-09-28 13:59:01 -04:00
README.md Working on btcpay backup/restore. 2022-10-26 21:41:14 -04:00
reset_env.sh Minor formatting and stability updates. 2022-10-30 12:59:24 -04:00
reset.sh Suppress error messages and timing. 2022-10-29 11:34:17 -04:00
show_lxc.sh Various refactors. Separting out VMs. 2022-08-24 10:11:50 -04:00

README.md

Documentation

The Sovereign Stack scripts in this repository are meant to be cloned to and executed from your management machine.

You can update Sovereign Stack scripts on your management machine by running git pull --all --tags. Generally, you want to use ONLY signed git tags for your deployments. Use git checkout v0.1.0 for example to switch to a specific version of Sovereign Stack. The scripts check to ensure that the code you're running on your management machine is GREATER THAN OR EQUAL TO the version of your deployments (TODO). The scripts work to bring your old deployments into line with the current Sovereign Stack version.

Once your managent machine checkedout a specific version of Sovereign stack, you will want to run the various scripts against your remotes. But before you can do that, you need to bring a bare-metal Ubuntu 22.04 cluster host under management (i.e., add it as a remote). Generally speaking you will run ss-cluster to bring a new bare-metal host under management of your management machine. This can be run AFTER you have verified SSH access to the bare-metal hosts. The device SHOULD also have a DHCP Reservation and DNS records in place.

After you have taken a machine under management, you can run ss-deploy it. All Sovereign Stack scripts execute against your current lxc remote. (Run lxc remote list to see your remotes). This will deploy Sovereign Stack software to your active remote in accordance with the various cluster, project, and site defintions. These files are stubbed out for the user automatically and documetnation guides the user through the process.

It is the responsiblity of the management machine (i.e,. system owner) to run the scripts on a regular and ongoing basis to ensure active deployments stay up-to-date with the Sovereign Stack master branch.

By default (i.e., without any command line modifiers), Sovereign Stack scripts will back up active deployments resulting in minimal downtime. (zero downtime for Ghost, minimal for Nextcloud/Gitea, BTCPAY Server).

All other documentation for this project can be found at the sovereign-stack.org.