diff options
author | Alex Auvolat <alex@adnab.me> | 2022-02-02 10:07:26 +0100 |
---|---|---|
committer | Alex Auvolat <alex@adnab.me> | 2022-02-02 10:07:26 +0100 |
commit | f5afa3d974e631de75c438cf2941a88440e2cf69 (patch) | |
tree | 9f9a89d10940757025b82ff8fdfbe3104c5f89a4 /content/documentation/development/scripts.md | |
parent | 921dd28f7499e46d78bd39d9ac7630efc50b64e8 (diff) | |
download | garagehq.deuxfleurs.fr-f5afa3d974e631de75c438cf2941a88440e2cf69.tar.gz garagehq.deuxfleurs.fr-f5afa3d974e631de75c438cf2941a88440e2cf69.zip |
Documentation from garage submodule
Diffstat (limited to 'content/documentation/development/scripts.md')
-rw-r--r-- | content/documentation/development/scripts.md | 117 |
1 files changed, 0 insertions, 117 deletions
diff --git a/content/documentation/development/scripts.md b/content/documentation/development/scripts.md deleted file mode 100644 index 34c921b..0000000 --- a/content/documentation/development/scripts.md +++ /dev/null @@ -1,117 +0,0 @@ -+++ -title = "Development scripts" -weight = 10 -+++ - - -We maintain a `script/` folder that contains some useful script to ease testing on Garage. - -A fully integrated script, `test-smoke.sh`, runs some basic tests on various tools such as minio client, awscli and rclone. -To run it, enter a `nix-shell` (or install all required tools) and simply run: - -```bash -nix-build # or cargo build -./script/test-smoke.sh -``` - -If something fails, you can find useful logs in `/tmp/garage.log`. -You can inspect the generated configuration and local data created by inspecting your `/tmp` directory: -the script creates files and folder prefixed with the name "garage". - -## Bootstrapping a test cluster - -Under the hood `test-smoke.sh` uses multiple helpers scripts you can also run in case you want to manually test Garage. -In this section, we introduce 3 scripts to quickly bootstrap a full test cluster with 3 instances. - -### 1. Start each daemon - -```bash -./script/dev-cluster.sh -``` - -This script spawns 3 Garage instances with 3 configuration files. -You can inspect the detailed configuration, including ports, by inspecting `/tmp/config.1` (change 1 by the instance number you want). - -This script also spawns a simple HTTPS reverse proxy through `socat` for the S3 endpoint that listens on port `4443`. -Some libraries might require a TLS endpoint to work, refer to our issue [#64](https://git.deuxfleurs.fr/Deuxfleurs/garage/issues/64) for more detailed information on this subject. - -This script covers the [Launching the garage server](/documentation/quick-start/overview/#launching-the-garage-server) section of our Quick start page. - -### 2. Make them join the cluster - -```bash -./script/dev-configure.sh -``` - -This script will configure each instance by assigning them a zone (`dc1`) and a weight (`1`). - -This script covers the [Configuring your Garage node](/documentation/quick-start/overview/) section of our Quick start page. - -### 3. Create a key and a bucket - -```bash -./script/dev-bucket.sh -``` - -This script will create a bucket named `eprouvette` with a key having read and write rights on this bucket. -The key is stored in a filed named `/tmp/garage.s3` and can be used by the following tools to pre-configure them. - -This script covers the [Creating buckets and keys](/documentation/quick-start/overview/#creating-buckets-and-keys) section of our Quick start page. - -## Handlers for generic tools - -We provide wrappers for some CLI tools that configure themselves for your development cluster. -They are meant to save you some configuration time as to use them, you are only required to source the right file. - -### awscli - -```bash -source ./script/dev-env-aws.sh - -# some examples -aws s3 ls s3://eprouvette -aws s3 cp /proc/cpuinfo s3://eprouvette/cpuinfo.txt -``` - -### minio-client - - -```bash -source ./script/dev-env-mc.sh - -# some examples -mc ls garage/ -mc cp /proc/cpuinfo garage/eprouvette/cpuinfo.txt -``` - -### rclone - -```bash -source ./script/dev-env-rclone.sh - -# some examples -rclone lsd garage: -rclone copy /proc/cpuinfo garage:eprouvette/cpuinfo.txt -``` - -### s3cmd - -```bash -source ./script/dev-env-s3cmd.sh - -# some examples -s3cmd ls -s3cmd put /proc/cpuinfo s3://eprouvette/cpuinfo.txt -``` - -### duck - -*Warning! Duck is not yet provided by nix-shell.* - -```bash -source ./script/dev-env-duck.sh - -# some examples -duck --list garage:/ -duck --upload garage:/eprouvette/ /proc/cpuinfo -``` |