diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..13760e8 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,9 @@ +{ + "markdownlint.config": { + "no-inline-html": { + "allowed_elements": [ + "br" + ] + } + } +} diff --git a/README.md b/README.md index a195bcb..e2a7dc7 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,6 @@ -# Summary +# Nextcloud Cron Job Docker Container + +## Summary This container is designed to run along side your Nextcloud container to execute its `/var/www/html/cron.php` at a regular interval. There is an "official" way of doing this, however it @@ -6,7 +8,7 @@ doesn't work when you run your Nextcloud container using a non-root user. I also that this solution is easier to manage, since it doesn't require the same environment as Nextcloud itself (i.e. no network requirements, no database requirements, etc). -# Setup Instructions +## Setup Instructions Since Nextcloud's entire setup can get rather complex with Docker, I highly recommend you set up everything using [Docker Compose](https://docs.docker.com/compose/). @@ -23,7 +25,7 @@ services: image: nextcloud:apache cron: - image: voidpointer/nextcloud-cronjob + image: rcdailey/nextcloud-cronjob restart: always network_mode: none depends_on: @@ -44,11 +46,12 @@ help identify the right container to execute the command in. Note that if you don't use Docker Compose, you can leave `NEXTCLOUD_PROJECT_NAME` blank or omitted entirely. -# Environment Variables +## Environment Variables * `NEXTCLOUD_CONTAINER_NAME`
Required. This is the name of the running Nextcloud container (or the service, if `NEXTCLOUD_PROJECT_NAME` is specified). + * `NEXTCLOUD_PROJECT_NAME`
The name of the project if you're using Docker Compose. The name of the project, by default, is the name of the context directory you ran your `docker-compose.yml` @@ -56,9 +59,11 @@ entirely. built as: ${NEXTCLOUD_PROJECT_NAME}_${NEXTCLOUD_CONTAINER_NAME} + * `NEXTCLOUD_CRON_MINUTE_INTERVAL`
The interval, in minutes, of how often the cron task executes. The default is 15 minutes. + * `NEXTCLOUD_EXEC_USER`
The user that should be used to run the cron tasks inside the Nextcloud container. This parameter is specified to the `docker exec` command from this container. By default, the user used is @@ -67,7 +72,7 @@ entirely. in the tasks being executed using the Nextcloud container's running user. Specifically, the `--user` option will *not* be provided to the `docker exec` command. -# Container Health +## Container Health If you do `docker-compose ps`, you will see the active health of the container. The following logic is checked every interval of the health check. If any of these checks fail, it is likely the @@ -79,7 +84,7 @@ container's health status will become *unhealthy*. In this case, you should rest container's ID. If for whatever reason the Nextcloud container changes in such a way that the ID is no longer valid, the health check would fail. -# Customizing Cron Tasks +## Customizing Cron Tasks This container provides the ability for you to run additional tasks inside the Nextcloud container in addition to the default `cron.php` task. To add your custom tasks, follow these steps: @@ -93,33 +98,35 @@ in addition to the default `cron.php` task. To add your custom tasks, follow the #!/usr/bin/env bash php -f /var/www/html/cron.php ``` + 1. Mount this shell script inside the `/cron-scripts` directory. Here's an example if you're using `docker-compose.yml`: ```yml services: cron: - image: voidpointer/nextcloud-cronjob + image: rcdailey/nextcloud-cronjob volumes: - ./my-scripts/do-something.sh:/cron-scripts/do-something.sh:ro ``` + 1. Recreate the container. Your script will now execute in the Nextcloud container at a regular interval. -## Notes +### Notes * All cron task shell scripts run at the same interval defined by `NEXTCLOUD_CRON_MINUTE_INTERVAL`. * Modification of your own shell scripts on the host do not require that you restart/recreate the container. -# Debugging +## Debugging All logs from `crond` are configured to print to stdout, so you can monitor container logs (via `docker-compose logs -f`). This should allow you to make sure your cron job is working. You can also use the "Overview" page in Nextcloud Settings to see if the cron job is being run regularly. Here is an example of the logs you will see: -``` +```txt Started crond ------------------------------------------------------------- Executing Cron Tasks: Thu Dec 6 17:28:00 CST 2018