added some more docz

README.md

@@ -30,5 +30,47 @@ follow this guide: https://docs.drone.io/server/provider/gitea/
 
 then you'll also need to setup drone-docker-runner (`abra app new drone-docker-runner`). More info at https://docs.drone.io/runner/docker/installation/linux/.
 
+
+## Setting up a server for auto-deployment
+
+For Drone to be able to deploy to a server, you need:
+
+- A drone user on the server, added to the `docker` group
+- An SSH key, added as a secret in Drone, and added to `/home/drone/.ssh/authorized_keys on the server`
+
+1. Add a `drone` user on `example.zone`, the server which you’re hosting the site on.
+	a. `sudo adduser drone`
+	b. create an SSH key for the user using `ssh-keygen` , e.g. `sudo -u drone ssh-keygen`
+	c. copy the contents of the public side of the new key to `/home/drone/.ssh/authorized_keys`
+	d. run `chmod go-rwx /home/drone/.ssh`
+	e. add `drone` to `AllowUsers` in `/etc/ssh/sshd_confand` restart SSH, `sudo service sshd restart`
+2. Give the drone user access to the `docker` group; `sudo usermod -aG docker drone`
+3. Generate a new SSH key and insert it as a Drone “orgsecret”
+	a. Log into Drone as `admin`, then either:
+	b. Add the “orgsecret” using the [Drone CLI](https://docs.drone.io/cli/install/):
+		i. Go to the “account” page https://drone.autonomic.zone/account
+		ii. Copy/paste the “Example CLI usage” into a terminal (you might want to add to `~/.bashrc` to make this easier  next time)
+		iii. Run `drone orgsecret add [org you're adding the org secret to] [domain name] @drone_ssh_[example.zone]`
+	c. Add the “orgsecret” using the Drone web interface:
+		i. Find the repository page, or the page for another repository in the same organisation, in Drone
+		ii. On the “Settings” tab, under “Organization” on the left, click “Secrets”, then create a new secret and paste in the private key value
+
+
 [`abra`]: https://git.autonomic.zone/autonomic-cooperative/abra
 [`coop-cloud/traefik`]: https://git.autonomic.zone/coop-cloud/traefik
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

README.md~

@@ -1,36 +0,0 @@
-# Drone
-
-[![Build Status](https://drone.autonomic.zone/api/badges/coop-cloud/drone/status.svg)](https://drone.autonomic.zone/coop-cloud/drone)
-
-<!-- metadata -->
-* **Category**: Apps
-* **Status**: 1, alpha
-* **Image**: [`drone/drone`](https://hub.docker.com/r/drone/drone), 4, upstream
-* **Healthcheck**: Yes
-* **Backups**: ?
-* **Email**: ?
-* **Tests**: 2
-* **SSO**: 3 (OAuth)
-<!-- endmetadata -->
-
-## Basic usage
-
-1. Set up Docker Swarm and [`abra`]
-2. Deploy [`coop-cloud/traefik`]
-3. `abra app new drone --secrets` (optionally with `--pass` if you'd like
-   to save secrets in `pass`)
-4. `abra app config YOURAPPDOMAIN` - be sure to change `DOMAIN` to something that resolves to
-   your Docker swarm box
-5. `abra app deploy YOURAPPDOMAIN`
-6. Open the configured domain in your browser to finish set-up
-
-## Setup with Gitea
-
-follow this guide: https://docs.drone.io/server/provider/gitea/
-
-then you'll also need to setup drone-docker-runner (`abra app new drone-docker-runner`). More info at https://docs.drone.io/runner/docker/installation/linux/.
-
-also it needs secrets added to the repo or the org.
-
-[`abra`]: https://git.autonomic.zone/autonomic-cooperative/abra
-[`coop-cloud/traefik`]: https://git.autonomic.zone/coop-cloud/traefik