Update README for new `abra` UI

This commit is contained in:
3wc 2020-12-14 12:28:46 +02:00
parent 26fa0bdfd3
commit 5c81094a82
1 changed files with 27 additions and 34 deletions

View File

@ -1,23 +1,19 @@
# wordpress # wordpress
[![Build Status](https://drone.autonomic.zone/api/badges/compose-stacks/wordpress/status.svg)](https://drone.autonomic.zone/compose-stacks/wordpress) [![Build Status](https://drone.autonomic.zone/api/badges/coop-cloud/wordpress/status.svg)](https://drone.autonomic.zone/coop-cloud/wordpress)
Coöp Cloud + [Wordpress](https://wordpress.org) = 🥳 Coöp Cloud + [Wordpress](https://wordpress.org) = 🥳
1. Set up Docker Swarm and [`abra`][abra] 1. Set up Docker Swarm and [`abra`][abra]
2. Deploy [`compose-stacks/traefik`][compose-traefik] 2. Deploy [`coop-cloud/traefik`][cc-traefik]
3. `cp .envrc.sample .envrc` 3. `abra app new wordpress`
4. Edit `.envrc` - be sure to change `$DOMAIN` to something that resolves to 4. `abra app YOURAPPDOMAIN config` - be sure to change `$DOMAIN` to something that resolves to
your Docker swarm box your Docker swarm box
5. `direnv allow` (or `. .envrc`) 5. `abra app YOURAPPDOMAIN secret auto` (optionally with `--pass` if you'd like
6. Generate secrets: to save secrets in `pass`).
``` 6. `abra app YOURAPPDOMAIN deploy`
abra secret_generate db_password v1 7. Open the configured domain in your browser to finish set-up
abra secret_generate db_root_password v1 8. `abra app YOURAPPDOMAIN run app chown www-data:www-data /var/www/html/wp-content` to fix
```
7. `abra deploy`
8. Open the configured domain in your browser to finish set-up
9. `abra run wordpress chown www-data:www-data /var/www/html/wp-content` to fix
file permissions (see #3) file permissions (see #3)
## Network (Multi-site) ## Network (Multi-site)
@ -25,35 +21,32 @@ Coöp Cloud + [Wordpress](https://wordpress.org) = 🥳
_(Only tested using subdomains)_ _(Only tested using subdomains)_
1. Set up as above 1. Set up as above
2. Uncomment the first `# Multisite` section in `.envrc` 2. `abra app YOURAPPDOMAIN config`, and uncomment the first `# Multisite` section
3. `direnv allow` (or re-run `source .envrc`) 3. `abra app YOURAPPDOMAIN deploy`
4. `abra deploy` 4. Log into the Wordpress admin dashboard, go to Tools » Network Setup
5. Log into the Wordpress admin dashboard, go to Tools » Network Setup 5. Don't worry about the suggested file changes
6. Don't worry about the suggested file changes 6. `abra app YOURAPPDOMAIN config` again - comment out the first `# Multisite`
7. Comment out the first `# Multisite` section in `.envrc`, uncomment the `# section in `.envrc`, uncomment the `# Multisite phase 2` section, and add
Multisite phase 2` section, and add your multisite subdomain(s) to your multisite subdomain(s) to `EXTRA_DOMAINS` (beware the weird syntax..)
`EXTRA_DOMAINS` (beware the weird syntax..) 7. `abra app YOURAPPDOMAIN deploy`
8. `direnv allow` (or re-run `source .envrc`)
9. `abra deploy`
## Installing a custom theme ## Installing a custom theme
`abra cp ~/path/to/local/theme wordpress:/var/www/html/wp-content/themes/` `abra app YOURAPPDOMAIN cp ~/path/to/local/theme wordpress:/var/www/html/wp-content/themes/`
## Backups ## Backups
1. Edit `.envrc` and uncomment the `export COMPOSE_FILE="compose.yml:compose.backup.yml"` line 1. `abra app YOURAPPDOMAIN config`, and uncomment the `export COMPOSE_FILE="compose.yml:compose.backup.yml"` line
2. `direnv allow` 2. `abra app YOURAPPDOMAIN deploy`
3. `abra deploy`
## Email ## Email
1. Deploy `postfix-relay` 1. Deploy [`postfix-relay`][cc-postfix-relay]
2. Edit `.envrc` and uncomment the email lines; change `MAIL_FROM` to make sure 2. `abra app YOURAPPDOMAIN config`, and uncomment the email lines; change
the domain is the same as `postfix-relay`'s `$DOMAIN` or in its `MAIL_FROM` to make sure the domain is the same as `postfix-relay`'s
`$EXTRA_SENDER_DOMAINS` `$DOMAIN` or in its `$EXTRA_SENDER_DOMAINS`
3. `direnv allow` (or `source .envrc`) 3. `abra app YOURAPPDOMAIN deploy`
7. `abra deploy`
[abra]: https://git.autonomic.zone/autonomic-cooperative/abra [abra]: https://git.autonomic.zone/autonomic-cooperative/abra
[compose-traefik]: https://git.autonomic.zone/compose-stacks/traefik [cc-traefik]: https://git.autonomic.zone/coop-cloud/traefik
[cc-postfix-relax]: https://git.autonomic.zone/coop-cloud/traefik