Update README for new `abra` UI
This commit is contained in:
parent
26fa0bdfd3
commit
5c81094a82
61
README.md
61
README.md
|
@ -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
|
||||||
|
|
Reference in New Issue