History

Giuliano Mega ec0f7a6790 Remove run ID and introduce deploy ID (#93 ) This PR removes the notion of a run id and replaces it with a deploy id in continuous tests. Deploy ids can be set at deploy time only (duh), and will be picked up by the test runner from the deploy file on subsequent runs of the continuous test runner. As a consequence, the deploy id becomes a deployer parameter, and can no longer be overridden at the runner. For non-continuous tests, the deploy ID is created on-the-fly.		2024-02-22 10:41:07 -03:00
..
CodexNetDeployer.csproj	Wires codex bot into deployer.	2023-10-24 10:29:07 +02:00
CodexNodeStarter.cs	Switches to automatic public IP address for codex and geth containers.	2023-11-15 14:53:25 +01:00
Configuration.cs	Remove run ID and introduce deploy ID (#93 )	2024-02-22 10:41:07 -03:00
Deployer.cs	Remove run ID and introduce deploy ID (#93 )	2024-02-22 10:41:07 -03:00
K8sHook.cs	Remove run ID and introduce deploy ID (#93 )	2024-02-22 10:41:07 -03:00
PeerConnectivityChecker.cs	Adds test for routing table checks.	2023-11-12 10:36:48 +01:00
Program.cs	Important user feedback message update	2023-10-25 09:54:08 +02:00
README.MD	Adds dockertag description	2023-09-29 10:40:48 +02:00
deploy-continuous-testnet.sh	Merge branch 'master' into deployment-json-rework	2023-11-08 09:29:22 +01:00
deploy-public-testnet.sh	Switches to automatic public IP address for codex and geth containers.	2023-11-15 14:53:25 +01:00

README.MD

CodexNetDeployer

This CLI tool allows you to create a network of Codex nodes in a kubernetes cluster. There are many arguments that allow you to configure every aspect of the deployment. Each argument can also be controlled using an environment variable. I won't copy-paste the list here because then it'll have to be kept up-to-date. Just run: dotnet run -- --help

Output

After the deployment has successfully finished, a codex-deployment.json file will be created. This file contains all the information necessary to interface with the deployed network. It can be used by other tools, for example the CodexContinuousTests runner CLI tool.

Overrides

The arguments allow you to configure quite a bit, but not everything. Here are some environment variables the CodexNetDeployer will respond to. None of these are required.

Variable	Description
RUNID	A pod-label 'runid' is added to each pod created during deployment. Use this to set the value of that label.
TESTID	Similar to RUNID, except the label is 'testid'.
CODEXDOCKERIMAGE	If set, this will be used instead of the default Codex docker image.

Using a local Codex repository

If you have a clone of the Codex git repository, and you want to deploy a network using your local modifications, the following environment variable options are for you. Please note that any changes made in Codex's 'vendor' directory will be discarded during the build process.

Variable	Description
CODEXREPOPATH	Path to the Codex repository.
DOCKERUSERNAME	Username of your Dockerhub account.
DOCKERPASSWORD	Password OR access-token for your Dockerhub account. You can omit this variable to use your system-default account.
DOCKERTAG	Optional. Tag used for docker image that will be built and pushed to the Dockerhub account. Random ID used when not set.