cinderella

[unmaintained] simple CI engine
Log | Files | Refs | README | LICENSE

commit f2d26950d9c422f247fe9f7d802954d61cf23134
parent f934fff380b682c7da1edaa352e54a3b49e5078c
Author: Stefan Koch <programming@stefan-koch.name>
Date:   Sun, 24 Nov 2019 14:24:00 +0100

update readme for new command structure

Diffstat:
MREADME.md | 23++++++++++++++++-------
1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md @@ -23,7 +23,7 @@ You can also manually execute Cinderella. To do so pass it the path to your git repository and optionally the name of the branch you want to build: ```bash -cinderella https://github.com/aufziehvogel/Cinderella.git --branch master +cinderella run https://github.com/aufziehvogel/Cinderella.git --branch master ``` You can use a different path than `.cinderella.toml` for your CI configuration @@ -32,7 +32,7 @@ to the git work directory. If you want to use a CI configuration file local to your shell directory use absolute paths. ```bash -cinderella https://github.com/aufziehvogel/Cinderella.git --file /home/user/cinderella-test.toml +cinderella run https://github.com/aufziehvogel/Cinderella.git --file /home/user/cinderella-test.toml ``` @@ -116,22 +116,31 @@ Encrypted Environment Variables ------------------------------- Sometimes a script needs to use credentials that you do not want to store in -a version control system in cleartext. For this use case, Cinderella supports +a version control system in plaintext. For this use case, Cinderella supports the storage of environment variables in an encrypted file. This file has to be stored in `.cinderella/secrets`. -In cleartext create a TOML file `secrets.toml` that looks as follows: +In plaintext create a TOML file `.cinderella/secrets.toml` that looks as +follows: ```toml USERNAME = "my-user" PASSWORD = "my-secret" ``` -You have to encrypt this file with GnuPG: +Optionally, you can add the plaintext file to your `.gitignore`. +You can create an encrypted file `.cinderella/secrets` by running the +following command from your project's root directory: ```bash -gpg -o .cinderella/secrets -c secrets.toml -rm secrets.toml +cinderella encrypt +``` + +After this step you may delete the `secrets.toml` if you want. To decrypt +the encrypted file (and re-create `secrets.toml`) run: + +```bash +cinderella decrypt ``` The password you chose during encryption has to be set in the *Cinderella