docker dependency, provisioning

This commit is contained in:
knoflook 2022-06-03 13:48:36 +02:00
parent 161c56430b
commit bbb29d0d7b
Signed by: knoflook
GPG Key ID: D6A1D0E8FC4FEF1C
1 changed files with 17 additions and 1 deletions

View File

@ -116,6 +116,16 @@ docker swarm init
docker network create -d overlay proxy
```
alternatively, if you want to provision your server with abra, instead of manually installing docker:
```
# add your user to sudo group
usermod -aG sudo $YOURUSERNAME
# install ssh-askpass
sudo apt update && sudo apt install ssh-askpass
```
!!! question "Do you support multiple web proxies?"
We do not know if it is feasible and convenient to set things up on an existing server with another web proxy which uses ports `:80` & `:443`. We'd happily receive reports and documentation on how to do this if you manage to set it up!
@ -137,6 +147,10 @@ Where `116.203.211.204` can be replaced with the IP address of your server.
### Command-line setup
#### Dependencies
You need to have Docker running on your local machine, and the user you're running abra from must have permission to control Docker. If you're having trouble, try adding yourself to the `docker` group, and re-logging.
#### Install `abra`
Now we can install [`abra`](/abra) locally on your machine and hook it up to your server.
@ -165,11 +179,13 @@ If you run into issues during installation, [please report a ticket](https://git
Now you can connect `abra` with your server. You need to have a working SSH configuration before you can do this. That means you can run `ssh <server-domain>` on your command-line and everything Works :tm:.
```bash
abra server add <server-domain> -p
abra server add <server-domain> -p -a
```
The `-p` or `--provision` flag means that `abra` will install Docker and initialise the [new single-host swarm](https://docs.docker.com/engine/swarm/key-concepts/) on your server. If you've already followed the steps in [the server setup](/operators/tutorial/#server-setup) step, then `abra` should not need to do any work.
The `-a` or `--ask-sudo-pass` flag means that abra will use `ssh-askpass` on your server to ask for sudo pass. Skip if you have passwordless sudo on your server or if logging in as root.
It is important to note that `<domain>` here is a publicy accessible domain name which points to your server IP address. `abra` does make sure this is the case and this is done to avoid issues with HTTPS certificate rate limiting.
You will now have a new `~/.abra/` folder on your local file system which stores all the configuration of your Co-op Cloud instance.