Update README and .env_example
This commit is contained in:
parent
6e964a69a7
commit
3c24688336
11
.env_example
11
.env_example
|
@ -1,2 +1,9 @@
|
||||||
ADMIN_EMAIL=admin
|
PORT=5000
|
||||||
ADMIN_PASSWORD=password
|
DOMAIN=adapt.localhost
|
||||||
|
DB_HOST=db
|
||||||
|
DB_NAME=adapt
|
||||||
|
DB_USER=adapt
|
||||||
|
SESSION_SECRET=foobar
|
||||||
|
ADMIN_EMAIL=foo@bar.com
|
||||||
|
ADMIN_PASSWORD=foo
|
||||||
|
FROM_EMAIL=adapt@localhost
|
||||||
|
|
120
README.md
120
README.md
|
@ -1,109 +1,37 @@
|
||||||
README.md
|
# docker-adaptauthoring
|
||||||
=================
|
|
||||||
|
|
||||||
Authoring SCORM-compatible training using the [Adapt Authoring](https://github.com/adaptlearning/adapt_authoring) tool at http://localhost:5000.
|
Authoring SCORM-compatible training using the [Adapt Authoring](https://github.com/adaptlearning/adapt_authoring) tool.
|
||||||
|
|
||||||
Login credentials are set from a .env file (See _Config_ section).
|
## How to use this image
|
||||||
|
|
||||||
Getting Started - docker-compose
|
Because Adapt requires a database to run, the easiest way to get started is to use `docker-compose` to set up Adapt and MongoDB automatically.
|
||||||
---------------------------------
|
|
||||||
|
|
||||||
### Config
|
Fetch the example `docker-compose.yml`:
|
||||||
|
|
||||||
Add an `.env` file with the following:
|
wget https://github.com/3-w-c/docker-adaptauthoring/blob/master/docker-compose.yml
|
||||||
|
|
||||||
```
|
Edit the variables under `services.app.environment`, then push the button!
|
||||||
ADMIN_EMAIL=admin
|
|
||||||
ADMIN_PASSWORD=password
|
|
||||||
```
|
|
||||||
|
|
||||||
This is read during "setup."
|
docker-compose up
|
||||||
|
|
||||||
### Setup
|
## Environment variables
|
||||||
|
|
||||||
Do this once:
|
You can configure Adapt's initial set-up using these variables:
|
||||||
|
|
||||||
```
|
- `DOMAIN` - hostname for the Adapt service
|
||||||
docker-compose up -d
|
- `PORT` (default `5000`) - TCP port for the Adapt service
|
||||||
```
|
- `DB_HOST` - MongoDB server hostname
|
||||||
|
- `DB_USER` - MongoDB username
|
||||||
|
- `DB_NAME` - MongoDB database name
|
||||||
|
- `SESSION_SECRET` - HTTP session secret key (set to something random)
|
||||||
|
- `ADMIN_EMAIL` - email address for the default superuser account
|
||||||
|
- `ADMIN_PASSWORD` - password for the default superuser account
|
||||||
|
- `FROM_EMAIL` - `From:` email address for notifications
|
||||||
|
|
||||||
docker-compose -f docker-compose.setup.yml run --rm setup
|
## Docker secrets
|
||||||
|
|
||||||
```
|
As well as environment variables, you can also load `SESSION_SECRET` and
|
||||||
|
`ADMIN_PASSWORD` from files, which is helpful if want to keep secret data in
|
||||||
|
[Docker swarm mode secrets](https://docs.docker.com/engine/swarm/secrets).
|
||||||
|
|
||||||
Subsequent runnings: `docker-compose up -d`.
|
Simply set `SESSION_SECRET_FILE` / `ADMIN_PASSWORD_FILE`.
|
||||||
|
|
||||||
### Clean Up
|
|
||||||
|
|
||||||
#### To remove containers
|
|
||||||
|
|
||||||
```
|
|
||||||
docker-compose down
|
|
||||||
```
|
|
||||||
|
|
||||||
#### To remove data (courses)
|
|
||||||
|
|
||||||
This will delete your hard work.
|
|
||||||
|
|
||||||
```
|
|
||||||
docker volume rm dockeradaptauthoring_adaptdb
|
|
||||||
docker volume rm dockeradaptauthoring_adaptdata
|
|
||||||
```
|
|
||||||
|
|
||||||
### Backup
|
|
||||||
|
|
||||||
Create local archives of both the adapt_authoring folder and database:
|
|
||||||
|
|
||||||
```
|
|
||||||
docker run -it -w /backup -v dockeradaptauthoring_adaptdb:/adaptdb -v $(pwd)/backup:/backup dockeradaptauthoring_authoring bash -c "tar -czvf adaptdata_`date +"%Y-%m-%d_%H-%M-%S"`.tar.gz /adapt_authoring && tar -czvf adaptdb_`date +"%Y-%m-%d_%H-%M-%S"`.tar.gz /adaptdb"
|
|
||||||
```
|
|
||||||
|
|
||||||
Getting Started - Using `docker run ...`
|
|
||||||
--------------------------------------------
|
|
||||||
|
|
||||||
### Setup
|
|
||||||
|
|
||||||
`docker run -d --name adaptdb -v adaptdb:/data/db mongo`
|
|
||||||
|
|
||||||
Adjust values such as `--email` and `--password` as desired:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker run -it -p 5000:5000 --link adaptdb --name adaptauthoring -v adaptdata:/adapt_authoring garyritchie/docker-adaptauthoring bash -c 'node install --install Y --serverPort 5000 --serverName localhost --dbHost adaptdb --dbName adapt-tenant-master --dbPort 27017 --dataRoot data --sessionSecret your-session-secret --useffmpeg Y --smtpService dummy --smtpUsername smtpUser --smtpPassword smtpPass --fromAddress you@example.com --name master --displayName Master --email admin --password password'
|
|
||||||
```
|
|
||||||
|
|
||||||
After a while the container should quit and you should see the following message"
|
|
||||||
|
|
||||||
```bash
|
|
||||||
Done, without errors.
|
|
||||||
|
|
||||||
The app.productname web application was compiled and is now ready to use.
|
|
||||||
Installation complete.
|
|
||||||
To restart your instance run the command 'pm2 restart all'
|
|
||||||
Bye!
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### Run
|
|
||||||
|
|
||||||
Once the "Setup" steps are complete, do:
|
|
||||||
|
|
||||||
`docker restart adaptauthoring`
|
|
||||||
|
|
||||||
Adapt authoring tool should now be available at http://localhost:5000/
|
|
||||||
|
|
||||||
|
|
||||||
### Upgrade
|
|
||||||
|
|
||||||
*Please Note:* Upgrading has had mixed results in recent tests.
|
|
||||||
|
|
||||||
Upgrade the AuthoringTool and or Framework (run in a shell):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker exec -it adaptauthoring bash -c 'node upgrade --Y/n Y'
|
|
||||||
```
|
|
||||||
|
|
||||||
`node upgrade` has been stalling... `docker run -it -p 5000:5000 --link adaptdb --name adaptauthoring -v adaptdata:/adapt_authoring garyritchie/docker-adaptauthoring bash -c 'node upgrade --Y/n Y'`
|
|
||||||
|
|
||||||
After a bit you should see:
|
|
||||||
|
|
||||||
`Great work! Your Adapt authoring tool is now updated.`
|
|
||||||
|
|
Loading…
Reference in New Issue