dokku/dokku-postgres
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: properly spell lollipop

Browse Source 
I've been misspelling my stand-in variable name for years...
This commit is contained in:
Jose Diaz-Gonzalez
2021-09-13 00:57:34 -04:00
parent 3ab20b0b4f
commit d72138aad3
30 changed files with 127 additions and 127 deletions
Download Patch File Download Diff File Expand all files Collapse all files

126
README.md
View File

@@ -74,10 +74,10 @@ flags:
- `-r|--root-password PASSWORD`: override the root-level service password - `-r|--root-password PASSWORD`: override the root-level service password
- `-s|--shm-size SHM_SIZE`: override shared memory size for postgres docker container - `-s|--shm-size SHM_SIZE`: override shared memory size for postgres docker container
Create a postgres service named lolipop: Create a postgres service named lollipop:
```shell ```shell
dokku postgres:create lolipop dokku postgres:create lollipop
``` ```
You can also specify the image and image version to use for the service. It *must* be compatible with the postgres image. You can also specify the image and image version to use for the service. It *must* be compatible with the postgres image.
@@ -85,14 +85,14 @@ You can also specify the image and image version to use for the service. It *mus
```shell ```shell
export POSTGRES_IMAGE="postgres" export POSTGRES_IMAGE="postgres"
export POSTGRES_IMAGE_VERSION="${PLUGIN_IMAGE_VERSION}" export POSTGRES_IMAGE_VERSION="${PLUGIN_IMAGE_VERSION}"
dokku postgres:create lolipop dokku postgres:create lollipop
``` ```
You can also specify custom environment variables to start the postgres service in semi-colon separated form. You can also specify custom environment variables to start the postgres service in semi-colon separated form.
```shell ```shell
export POSTGRES_CUSTOM_ENV="USER=alpha;HOST=beta" export POSTGRES_CUSTOM_ENV="USER=alpha;HOST=beta"
dokku postgres:create lolipop dokku postgres:create lollipop
``` ```
### print the service information ### print the service information
@@ -118,22 +118,22 @@ flags:
Get connection information as follows: Get connection information as follows:
```shell ```shell
dokku postgres:info lolipop dokku postgres:info lollipop
``` ```
You can also retrieve a specific piece of service info via flags: You can also retrieve a specific piece of service info via flags:
```shell ```shell
dokku postgres:info lolipop --config-dir dokku postgres:info lollipop --config-dir
dokku postgres:info lolipop --data-dir dokku postgres:info lollipop --data-dir
dokku postgres:info lolipop --dsn dokku postgres:info lollipop --dsn
dokku postgres:info lolipop --exposed-ports dokku postgres:info lollipop --exposed-ports
dokku postgres:info lolipop --id dokku postgres:info lollipop --id
dokku postgres:info lolipop --internal-ip dokku postgres:info lollipop --internal-ip
dokku postgres:info lolipop --links dokku postgres:info lollipop --links
dokku postgres:info lolipop --service-root dokku postgres:info lollipop --service-root
dokku postgres:info lolipop --status dokku postgres:info lollipop --status
dokku postgres:info lolipop --version dokku postgres:info lollipop --version
``` ```
### list all postgres services ### list all postgres services
@@ -163,13 +163,13 @@ flags:
You can tail logs for a particular service: You can tail logs for a particular service:
```shell ```shell
dokku postgres:logs lolipop dokku postgres:logs lollipop
``` ```
By default, logs will not be tailed, but you can do this with the --tail flag: By default, logs will not be tailed, but you can do this with the --tail flag:
```shell ```shell
dokku postgres:logs lolipop --tail dokku postgres:logs lollipop --tail
``` ```
### link the postgres service to the app ### link the postgres service to the app
@@ -189,24 +189,24 @@ A postgres service can be linked to a container. This will use native docker lin
> NOTE: this will restart your app > NOTE: this will restart your app
```shell ```shell
dokku postgres:link lolipop playground dokku postgres:link lollipop playground
``` ```
The following environment variables will be set automatically by docker (not on the app itself, so they won’t be listed when calling dokku config): The following environment variables will be set automatically by docker (not on the app itself, so they won’t be listed when calling dokku config):
``` ```
DOKKU_POSTGRES_LOLIPOP_NAME=/lolipop/DATABASE DOKKU_POSTGRES_LOLLIPOP_NAME=/lollipop/DATABASE
DOKKU_POSTGRES_LOLIPOP_PORT=tcp://172.17.0.1:5432 DOKKU_POSTGRES_LOLLIPOP_PORT=tcp://172.17.0.1:5432
DOKKU_POSTGRES_LOLIPOP_PORT_5432_TCP=tcp://172.17.0.1:5432 DOKKU_POSTGRES_LOLLIPOP_PORT_5432_TCP=tcp://172.17.0.1:5432
DOKKU_POSTGRES_LOLIPOP_PORT_5432_TCP_PROTO=tcp DOKKU_POSTGRES_LOLLIPOP_PORT_5432_TCP_PROTO=tcp
DOKKU_POSTGRES_LOLIPOP_PORT_5432_TCP_PORT=5432 DOKKU_POSTGRES_LOLLIPOP_PORT_5432_TCP_PORT=5432
DOKKU_POSTGRES_LOLIPOP_PORT_5432_TCP_ADDR=172.17.0.1 DOKKU_POSTGRES_LOLLIPOP_PORT_5432_TCP_ADDR=172.17.0.1
``` ```
The following will be set on the linked application by default: The following will be set on the linked application by default:
``` ```
DATABASE_URL=postgres://lolipop:SOME_PASSWORD@dokku-postgres-lolipop:5432/lolipop DATABASE_URL=postgres://lollipop:SOME_PASSWORD@dokku-postgres-lollipop:5432/lollipop
``` ```
The host exposed here only works internally in docker containers. If you want your container to be reachable from outside, you should use the `expose` subcommand. Another service can be linked to your app: The host exposed here only works internally in docker containers. If you want your container to be reachable from outside, you should use the `expose` subcommand. Another service can be linked to your app:
@@ -219,13 +219,13 @@ It is possible to change the protocol for `DATABASE_URL` by setting the environm
```shell ```shell
dokku config:set playground POSTGRES_DATABASE_SCHEME=postgres2 dokku config:set playground POSTGRES_DATABASE_SCHEME=postgres2
dokku postgres:link lolipop playground dokku postgres:link lollipop playground
``` ```
This will cause `DATABASE_URL` to be set as: This will cause `DATABASE_URL` to be set as:
``` ```
postgres2://lolipop:SOME_PASSWORD@dokku-postgres-lolipop:5432/lolipop postgres2://lollipop:SOME_PASSWORD@dokku-postgres-lollipop:5432/lollipop
``` ```
### unlink the postgres service from the app ### unlink the postgres service from the app
@@ -240,7 +240,7 @@ You can unlink a postgres service:
> NOTE: this will restart your app and unset related environment variables > NOTE: this will restart your app and unset related environment variables
```shell ```shell
dokku postgres:unlink lolipop playground dokku postgres:unlink lollipop playground
``` ```
### Service Lifecycle ### Service Lifecycle
@@ -257,7 +257,7 @@ dokku postgres:connect <service>
Connect to the service via the postgres connection tool: Connect to the service via the postgres connection tool:
```shell ```shell
dokku postgres:connect lolipop dokku postgres:connect lollipop
``` ```
### enter or run a command in a running postgres service container ### enter or run a command in a running postgres service container
@@ -270,13 +270,13 @@ dokku postgres:enter <service>
A bash prompt can be opened against a running service. Filesystem changes will not be saved to disk. A bash prompt can be opened against a running service. Filesystem changes will not be saved to disk.
```shell ```shell
dokku postgres:enter lolipop dokku postgres:enter lollipop
``` ```
You may also run a command directly against the service. Filesystem changes will not be saved to disk. You may also run a command directly against the service. Filesystem changes will not be saved to disk.
```shell ```shell
dokku postgres:enter lolipop touch /tmp/test dokku postgres:enter lollipop touch /tmp/test
``` ```
### expose a postgres service on custom host:port if provided (random port on the 0.0.0.0 interface if otherwise unspecified) ### expose a postgres service on custom host:port if provided (random port on the 0.0.0.0 interface if otherwise unspecified)
@@ -289,13 +289,13 @@ dokku postgres:expose <service> <ports...>
Expose the service on the service's normal ports, allowing access to it from the public interface (`0.0.0.0`): Expose the service on the service's normal ports, allowing access to it from the public interface (`0.0.0.0`):
```shell ```shell
dokku postgres:expose lolipop 5432 dokku postgres:expose lollipop 5432
``` ```
Expose the service on the service's normal ports, with the first on a specified ip adddress (127.0.0.1): Expose the service on the service's normal ports, with the first on a specified ip adddress (127.0.0.1):
```shell ```shell
dokku postgres:expose lolipop 127.0.0.1:5432 dokku postgres:expose lollipop 127.0.0.1:5432
``` ```
### unexpose a previously exposed postgres service ### unexpose a previously exposed postgres service
@@ -308,7 +308,7 @@ dokku postgres:unexpose <service>
Unexpose the service, removing access to it from the public interface (`0.0.0.0`): Unexpose the service, removing access to it from the public interface (`0.0.0.0`):
```shell ```shell
dokku postgres:unexpose lolipop dokku postgres:unexpose lollipop
``` ```
### promote service <service> as DATABASE_URL in <app> ### promote service <service> as DATABASE_URL in <app>
@@ -337,7 +337,7 @@ This will replace `DATABASE_URL` with the url from other_service and generate an
``` ```
DATABASE_URL=postgres://other_service:ANOTHER_PASSWORD@dokku-postgres-other-service:5432/other_service DATABASE_URL=postgres://other_service:ANOTHER_PASSWORD@dokku-postgres-other-service:5432/other_service
DOKKU_DATABASE_BLUE_URL=postgres://other_service:ANOTHER_PASSWORD@dokku-postgres-other-service:5432/other_service DOKKU_DATABASE_BLUE_URL=postgres://other_service:ANOTHER_PASSWORD@dokku-postgres-other-service:5432/other_service
DOKKU_DATABASE_SILVER_URL=postgres://lolipop:SOME_PASSWORD@dokku-postgres-lolipop:5432/lolipop DOKKU_DATABASE_SILVER_URL=postgres://lollipop:SOME_PASSWORD@dokku-postgres-lollipop:5432/lollipop
``` ```
### start a previously stopped postgres service ### start a previously stopped postgres service
@@ -350,7 +350,7 @@ dokku postgres:start <service>
Start the service: Start the service:
```shell ```shell
dokku postgres:start lolipop dokku postgres:start lollipop
``` ```
### stop a running postgres service ### stop a running postgres service
@@ -363,7 +363,7 @@ dokku postgres:stop <service>
Stop the service and the running container: Stop the service and the running container:
```shell ```shell
dokku postgres:stop lolipop dokku postgres:stop lollipop
``` ```
### graceful shutdown and restart of the postgres service container ### graceful shutdown and restart of the postgres service container
@@ -376,7 +376,7 @@ dokku postgres:restart <service>
Restart the service: Restart the service:
```shell ```shell
dokku postgres:restart lolipop dokku postgres:restart lollipop
``` ```
### upgrade service <service> to the specified versions ### upgrade service <service> to the specified versions
@@ -398,7 +398,7 @@ flags:
You can upgrade an existing service to a new image or image-version: You can upgrade an existing service to a new image or image-version:
```shell ```shell
dokku postgres:upgrade lolipop dokku postgres:upgrade lollipop
``` ```
### Service Automation ### Service Automation
@@ -439,7 +439,7 @@ flags:
You can clone an existing service to a new one: You can clone an existing service to a new one:
```shell ```shell
dokku postgres:clone lolipop lolipop-2 dokku postgres:clone lollipop lollipop-2
``` ```
### check if the postgres service exists ### check if the postgres service exists
@@ -449,10 +449,10 @@ dokku postgres:clone lolipop lolipop-2
dokku postgres:exists <service> dokku postgres:exists <service>
``` ```
Here we check if the lolipop postgres service exists. Here we check if the lollipop postgres service exists.
```shell ```shell
dokku postgres:exists lolipop dokku postgres:exists lollipop
``` ```
### check if the postgres service is linked to an app ### check if the postgres service is linked to an app
@@ -462,10 +462,10 @@ dokku postgres:exists lolipop
dokku postgres:linked <service> <app> dokku postgres:linked <service> <app>
``` ```
Here we check if the lolipop postgres service is linked to the `playground` app. Here we check if the lollipop postgres service is linked to the `playground` app.
```shell ```shell
dokku postgres:linked lolipop playground dokku postgres:linked lollipop playground
``` ```
### list all apps linked to the postgres service ### list all apps linked to the postgres service
@@ -475,10 +475,10 @@ dokku postgres:linked lolipop playground
dokku postgres:links <service> dokku postgres:links <service>
``` ```
List all apps linked to the `lolipop` postgres service. List all apps linked to the `lollipop` postgres service.
```shell ```shell
dokku postgres:links lolipop dokku postgres:links lollipop
``` ```
### Data Management ### Data Management
@@ -495,7 +495,7 @@ dokku postgres:import <service>
Import a datastore dump: Import a datastore dump:
```shell ```shell
dokku postgres:import lolipop < database.dump dokku postgres:import lollipop < database.dump
``` ```
### export a dump of the postgres service database ### export a dump of the postgres service database
@@ -508,13 +508,13 @@ dokku postgres:export <service>
By default, datastore output is exported to stdout: By default, datastore output is exported to stdout:
```shell ```shell
dokku postgres:export lolipop dokku postgres:export lollipop
``` ```
You can redirect this output to a file: You can redirect this output to a file:
```shell ```shell
dokku postgres:export lolipop > lolipop.dump dokku postgres:export lollipop > lollipop.dump
``` ```
### Backups ### Backups
@@ -535,25 +535,25 @@ dokku postgres:backup-auth <service> <aws-access-key-id> <aws-secret-access-key>
Setup s3 backup authentication: Setup s3 backup authentication:
```shell ```shell
dokku postgres:backup-auth lolipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY dokku postgres:backup-auth lollipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY
``` ```
Setup s3 backup authentication with different region: Setup s3 backup authentication with different region:
```shell ```shell
dokku postgres:backup-auth lolipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION dokku postgres:backup-auth lollipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION
``` ```
Setup s3 backup authentication with different signature version and endpoint: Setup s3 backup authentication with different signature version and endpoint:
```shell ```shell
dokku postgres:backup-auth lolipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION AWS_SIGNATURE_VERSION ENDPOINT_URL dokku postgres:backup-auth lollipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION AWS_SIGNATURE_VERSION ENDPOINT_URL
``` ```
More specific example for minio auth: More specific example for minio auth:
```shell ```shell
dokku postgres:backup-auth lolipop MINIO_ACCESS_KEY_ID MINIO_SECRET_ACCESS_KEY us-east-1 s3v4 https://YOURMINIOSERVICE dokku postgres:backup-auth lollipop MINIO_ACCESS_KEY_ID MINIO_SECRET_ACCESS_KEY us-east-1 s3v4 https://YOURMINIOSERVICE
``` ```
### remove backup authentication for the postgres service ### remove backup authentication for the postgres service
@@ -566,7 +566,7 @@ dokku postgres:backup-deauth <service>
Remove s3 authentication: Remove s3 authentication:
```shell ```shell
dokku postgres:backup-deauth lolipop dokku postgres:backup-deauth lollipop
``` ```
### create a backup of the postgres service to an existing s3 bucket ### create a backup of the postgres service to an existing s3 bucket
@@ -580,16 +580,16 @@ flags:
- `-u|--use-iam`: use the IAM profile associated with the current server - `-u|--use-iam`: use the IAM profile associated with the current server
Backup the `lolipop` service to the `my-s3-bucket` bucket on `AWS`:` Backup the `lollipop` service to the `my-s3-bucket` bucket on `AWS`:`
```shell ```shell
dokku postgres:backup lolipop my-s3-bucket --use-iam dokku postgres:backup lollipop my-s3-bucket --use-iam
``` ```
Restore a backup file (assuming it was extracted via `tar -xf backup.tgz`): Restore a backup file (assuming it was extracted via `tar -xf backup.tgz`):
```shell ```shell
dokku postgres:import lolipop < backup-folder/export dokku postgres:import lollipop < backup-folder/export
``` ```
### set encryption for all future backups of postgres service ### set encryption for all future backups of postgres service
@@ -602,7 +602,7 @@ dokku postgres:backup-set-encryption <service> <passphrase>
Set the GPG-compatible passphrase for encrypting backups for backups: Set the GPG-compatible passphrase for encrypting backups for backups:
```shell ```shell
dokku postgres:backup-set-encryption lolipop dokku postgres:backup-set-encryption lollipop
``` ```
### unset encryption for future backups of the postgres service ### unset encryption for future backups of the postgres service
@@ -615,7 +615,7 @@ dokku postgres:backup-unset-encryption <service>
Unset the `GPG` encryption passphrase for backups: Unset the `GPG` encryption passphrase for backups:
```shell ```shell
dokku postgres:backup-unset-encryption lolipop dokku postgres:backup-unset-encryption lollipop
``` ```
### schedule a backup of the postgres service ### schedule a backup of the postgres service
@@ -634,13 +634,13 @@ Schedule a backup:
> 'schedule' is a crontab expression, eg. "0 3 * * *" for each day at 3am > 'schedule' is a crontab expression, eg. "0 3 * * *" for each day at 3am
```shell ```shell
dokku postgres:backup-schedule lolipop "0 3 * * *" my-s3-bucket dokku postgres:backup-schedule lollipop "0 3 * * *" my-s3-bucket
``` ```
Schedule a backup and authenticate via iam: Schedule a backup and authenticate via iam:
```shell ```shell
dokku postgres:backup-schedule lolipop "0 3 * * *" my-s3-bucket --use-iam dokku postgres:backup-schedule lollipop "0 3 * * *" my-s3-bucket --use-iam
``` ```
### cat the contents of the configured backup cronfile for the service ### cat the contents of the configured backup cronfile for the service
@@ -653,7 +653,7 @@ dokku postgres:backup-schedule-cat <service>
Cat the contents of the configured backup cronfile for the service: Cat the contents of the configured backup cronfile for the service:
```shell ```shell
dokku postgres:backup-schedule-cat lolipop dokku postgres:backup-schedule-cat lollipop
``` ```
### unschedule the backup of the postgres service ### unschedule the backup of the postgres service
@@ -666,7 +666,7 @@ dokku postgres:backup-unschedule <service>
Remove the scheduled backup from cron: Remove the scheduled backup from cron:
```shell ```shell
dokku postgres:backup-unschedule lolipop dokku postgres:backup-unschedule lollipop
``` ```
### Disabling `docker pull` calls ### Disabling `docker pull` calls

6
subcommands/backup
View File

@@ -6,10 +6,10 @@ source "$PLUGIN_BASE_PATH/common/functions"
source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions" source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-cmd() { service-backup-cmd() {
#E backup the 'lolipop' service to the 'my-s3-bucket' bucket on AWS #E backup the 'lollipop' service to the 'my-s3-bucket' bucket on AWS
#E dokku $PLUGIN_COMMAND_PREFIX:backup lolipop my-s3-bucket --use-iam #E dokku $PLUGIN_COMMAND_PREFIX:backup lollipop my-s3-bucket --use-iam
#E restore a backup file (assuming it was extracted via 'tar -xf backup.tgz') #E restore a backup file (assuming it was extracted via 'tar -xf backup.tgz')
#E dokku $PLUGIN_COMMAND_PREFIX:import lolipop < backup-folder/export #E dokku $PLUGIN_COMMAND_PREFIX:import lollipop < backup-folder/export
#F -u|--use-iam, use the IAM profile associated with the current server #F -u|--use-iam, use the IAM profile associated with the current server
#A service, service to run command against #A service, service to run command against
#A bucket-name, name of the s3 bucket to upload backups to #A bucket-name, name of the s3 bucket to upload backups to

8
subcommands/backup-auth
View File

@@ -7,13 +7,13 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-auth-cmd() { service-backup-auth-cmd() {
#E setup s3 backup authentication #E setup s3 backup authentication
#E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lolipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY #E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lollipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY
#E setup s3 backup authentication with different region #E setup s3 backup authentication with different region
#E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lolipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION #E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lollipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION
#E setup s3 backup authentication with different signature version and endpoint #E setup s3 backup authentication with different signature version and endpoint
#E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lolipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION AWS_SIGNATURE_VERSION ENDPOINT_URL #E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lollipop AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_REGION AWS_SIGNATURE_VERSION ENDPOINT_URL
#E more specific example for minio auth #E more specific example for minio auth
#E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lolipop MINIO_ACCESS_KEY_ID MINIO_SECRET_ACCESS_KEY us-east-1 s3v4 https://YOURMINIOSERVICE #E dokku $PLUGIN_COMMAND_PREFIX:backup-auth lollipop MINIO_ACCESS_KEY_ID MINIO_SECRET_ACCESS_KEY us-east-1 s3v4 https://YOURMINIOSERVICE
#A service, service to run command against #A service, service to run command against
#A access-key-id, an amazon AWS_ACCESS_KEY_ID #A access-key-id, an amazon AWS_ACCESS_KEY_ID
#A aws-secret-access-key, an amazon AWS_SECRET_ACCESS_KEY #A aws-secret-access-key, an amazon AWS_SECRET_ACCESS_KEY

2
subcommands/backup-deauth
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-deauth-cmd() { service-backup-deauth-cmd() {
#E remove s3 authentication #E remove s3 authentication
#E dokku $PLUGIN_COMMAND_PREFIX:backup-deauth lolipop #E dokku $PLUGIN_COMMAND_PREFIX:backup-deauth lollipop
#A service, service to run command against #A service, service to run command against
declare desc="remove backup authentication for the $PLUGIN_SERVICE service" declare desc="remove backup authentication for the $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:backup-deauth" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:backup-deauth" argv=("$@")

4
subcommands/backup-schedule
View File

@@ -8,9 +8,9 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-schedule-cmd() { service-backup-schedule-cmd() {
#E schedule a backup #E schedule a backup
#E > 'schedule' is a crontab expression, eg. "0 3 * * *" for each day at 3am #E > 'schedule' is a crontab expression, eg. "0 3 * * *" for each day at 3am
#E dokku $PLUGIN_COMMAND_PREFIX:backup-schedule lolipop "0 3 * * *" my-s3-bucket #E dokku $PLUGIN_COMMAND_PREFIX:backup-schedule lollipop "0 3 * * *" my-s3-bucket
#E schedule a backup and authenticate via iam #E schedule a backup and authenticate via iam
#E dokku $PLUGIN_COMMAND_PREFIX:backup-schedule lolipop "0 3 * * *" my-s3-bucket --use-iam #E dokku $PLUGIN_COMMAND_PREFIX:backup-schedule lollipop "0 3 * * *" my-s3-bucket --use-iam
#F -u|--use-iam, use the IAM profile associated with the current server #F -u|--use-iam, use the IAM profile associated with the current server
#A service, service to run command against #A service, service to run command against
#A schedule, a cron schedule to run backups on #A schedule, a cron schedule to run backups on

2
subcommands/backup-schedule-cat
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-schedule-cat-cmd() { service-backup-schedule-cat-cmd() {
#E cat the contents of the configured backup cronfile for the service #E cat the contents of the configured backup cronfile for the service
#E dokku $PLUGIN_COMMAND_PREFIX:backup-schedule-cat lolipop #E dokku $PLUGIN_COMMAND_PREFIX:backup-schedule-cat lollipop
#A service, service to run command against #A service, service to run command against
declare desc="cat the contents of the configured backup cronfile for the service" declare desc="cat the contents of the configured backup cronfile for the service"
local cmd="$PLUGIN_COMMAND_PREFIX:backup-schedule-cat" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:backup-schedule-cat" argv=("$@")

2
subcommands/backup-set-encryption
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-set-encryption-cmd() { service-backup-set-encryption-cmd() {
#E set the GPG-compatible passphrase for encrypting backups for backups #E set the GPG-compatible passphrase for encrypting backups for backups
#E dokku $PLUGIN_COMMAND_PREFIX:backup-set-encryption lolipop #E dokku $PLUGIN_COMMAND_PREFIX:backup-set-encryption lollipop
#A service, service to run command against #A service, service to run command against
#A passphrase, a GPG-compatible passphrase #A passphrase, a GPG-compatible passphrase
declare desc="set encryption for all future backups of $PLUGIN_SERVICE service" declare desc="set encryption for all future backups of $PLUGIN_SERVICE service"

2
subcommands/backup-unschedule
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-unschedule-cmd() { service-backup-unschedule-cmd() {
#E remove the scheduled backup from cron #E remove the scheduled backup from cron
#E dokku $PLUGIN_COMMAND_PREFIX:backup-unschedule lolipop #E dokku $PLUGIN_COMMAND_PREFIX:backup-unschedule lollipop
#A service, service to run command against #A service, service to run command against
declare desc="unschedule the backup of the $PLUGIN_SERVICE service" declare desc="unschedule the backup of the $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:backup-unschedule" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:backup-unschedule" argv=("$@")

2
subcommands/backup-unset-encryption
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-backup-unset-encryption-cmd() { service-backup-unset-encryption-cmd() {
#E unset the GPG encryption passphrase for backups #E unset the GPG encryption passphrase for backups
#E dokku $PLUGIN_COMMAND_PREFIX:backup-unset-encryption lolipop #E dokku $PLUGIN_COMMAND_PREFIX:backup-unset-encryption lollipop
#A service, service to run command against #A service, service to run command against
declare desc="unset encryption for future backups of the $PLUGIN_SERVICE service" declare desc="unset encryption for future backups of the $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:backup-unset-encryption" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:backup-unset-encryption" argv=("$@")

2
subcommands/clone
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-clone-cmd() { service-clone-cmd() {
#E you can clone an existing service to a new one #E you can clone an existing service to a new one
#E dokku $PLUGIN_COMMAND_PREFIX:clone lolipop lolipop-2 #E dokku $PLUGIN_COMMAND_PREFIX:clone lollipop lollipop-2
#A service, service to run command against #A service, service to run command against
#A new-service, name of new service #A new-service, name of new service
#F -c|--config-options "--args --go=here", extra arguments to pass to the container create command #F -c|--config-options "--args --go=here", extra arguments to pass to the container create command

2
subcommands/connect
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-connect-cmd() { service-connect-cmd() {
#E connect to the service via the $PLUGIN_COMMAND_PREFIX connection tool #E connect to the service via the $PLUGIN_COMMAND_PREFIX connection tool
#E dokku $PLUGIN_COMMAND_PREFIX:connect lolipop #E dokku $PLUGIN_COMMAND_PREFIX:connect lollipop
#A service, service to run command against #A service, service to run command against
declare desc="connect to the service via the $PLUGIN_COMMAND_PREFIX connection tool" declare desc="connect to the service via the $PLUGIN_COMMAND_PREFIX connection tool"
local cmd="$PLUGIN_COMMAND_PREFIX:connect" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:connect" argv=("$@")

8
subcommands/create
View File

@@ -6,17 +6,17 @@ source "$PLUGIN_BASE_PATH/common/functions"
source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions" source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-create-cmd() { service-create-cmd() {
#E create a $PLUGIN_COMMAND_PREFIX service named lolipop #E create a $PLUGIN_COMMAND_PREFIX service named lollipop
#E dokku $PLUGIN_COMMAND_PREFIX:create lolipop #E dokku $PLUGIN_COMMAND_PREFIX:create lollipop
#E you can also specify the image and image version to use for the service. #E you can also specify the image and image version to use for the service.
#E it *must* be compatible with the ${PLUGIN_IMAGE} image. #E it *must* be compatible with the ${PLUGIN_IMAGE} image.
#E export ${PLUGIN_VARIABLE}_IMAGE="${PLUGIN_IMAGE}" #E export ${PLUGIN_VARIABLE}_IMAGE="${PLUGIN_IMAGE}"
#E export ${PLUGIN_VARIABLE}_IMAGE_VERSION="${PLUGIN_IMAGE_VERSION}" #E export ${PLUGIN_VARIABLE}_IMAGE_VERSION="${PLUGIN_IMAGE_VERSION}"
#E dokku $PLUGIN_COMMAND_PREFIX:create lolipop #E dokku $PLUGIN_COMMAND_PREFIX:create lollipop
#E you can also specify custom environment variables to start #E you can also specify custom environment variables to start
#E the ${PLUGIN_COMMAND_PREFIX} service in semi-colon separated form. #E the ${PLUGIN_COMMAND_PREFIX} service in semi-colon separated form.
#E export ${PLUGIN_VARIABLE}_CUSTOM_ENV="USER=alpha;HOST=beta" #E export ${PLUGIN_VARIABLE}_CUSTOM_ENV="USER=alpha;HOST=beta"
#E dokku $PLUGIN_COMMAND_PREFIX:create lolipop #E dokku $PLUGIN_COMMAND_PREFIX:create lollipop
#A service, service to run command against #A service, service to run command against
#F -c|--config-options "--args --go=here", extra arguments to pass to the container create command #F -c|--config-options "--args --go=here", extra arguments to pass to the container create command
#F -C|--custom-env "USER=alpha;HOST=beta", semi-colon delimited environment variables to start the service with #F -C|--custom-env "USER=alpha;HOST=beta", semi-colon delimited environment variables to start the service with

2
subcommands/destroy
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-destroy-cmd() { service-destroy-cmd() {
#E destroy the service, it's data, and the running container #E destroy the service, it's data, and the running container
#E dokku $PLUGIN_COMMAND_PREFIX:destroy lolipop #E dokku $PLUGIN_COMMAND_PREFIX:destroy lollipop
#A service, service to run command against #A service, service to run command against
#F -f|--force, force destroy without asking for confirmation #F -f|--force, force destroy without asking for confirmation
declare desc="delete the $PLUGIN_SERVICE service/data/container if there are no links left" declare desc="delete the $PLUGIN_SERVICE service/data/container if there are no links left"

4
subcommands/enter
View File

@@ -8,10 +8,10 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-enter-cmd() { service-enter-cmd() {
#E a bash prompt can be opened against a running service. #E a bash prompt can be opened against a running service.
#E filesystem changes will not be saved to disk. #E filesystem changes will not be saved to disk.
#E dokku $PLUGIN_COMMAND_PREFIX:enter lolipop #E dokku $PLUGIN_COMMAND_PREFIX:enter lollipop
#E you may also run a command directly against the service. #E you may also run a command directly against the service.
#E filesystem changes will not be saved to disk. #E filesystem changes will not be saved to disk.
#E dokku $PLUGIN_COMMAND_PREFIX:enter lolipop touch /tmp/test #E dokku $PLUGIN_COMMAND_PREFIX:enter lollipop touch /tmp/test
#A service, service to run command against #A service, service to run command against
declare desc="enter or run a command in a running $PLUGIN_SERVICE service container" declare desc="enter or run a command in a running $PLUGIN_SERVICE service container"
local cmd="$PLUGIN_COMMAND_PREFIX:enter" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:enter" argv=("$@")

4
subcommands/exists
View File

@@ -6,8 +6,8 @@ source "$PLUGIN_BASE_PATH/common/functions"
source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions" source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-exists-cmd() { service-exists-cmd() {
#E here we check if the lolipop $PLUGIN_COMMAND_PREFIX service exists. #E here we check if the lollipop $PLUGIN_COMMAND_PREFIX service exists.
#E dokku $PLUGIN_COMMAND_PREFIX:exists lolipop #E dokku $PLUGIN_COMMAND_PREFIX:exists lollipop
#A service, service to run command against #A service, service to run command against
declare desc="check if the $PLUGIN_SERVICE service exists" declare desc="check if the $PLUGIN_SERVICE service exists"
local cmd="$PLUGIN_COMMAND_PREFIX:exists" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:exists" argv=("$@")

4
subcommands/export
View File

@@ -7,9 +7,9 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-export-cmd() { service-export-cmd() {
#E by default, datastore output is exported to stdout #E by default, datastore output is exported to stdout
#E dokku $PLUGIN_COMMAND_PREFIX:export lolipop #E dokku $PLUGIN_COMMAND_PREFIX:export lollipop
#E you can redirect this output to a file #E you can redirect this output to a file
#E dokku $PLUGIN_COMMAND_PREFIX:export lolipop > lolipop.dump #E dokku $PLUGIN_COMMAND_PREFIX:export lollipop > lollipop.dump
#A service, service to run command against #A service, service to run command against
declare desc="export a dump of the $PLUGIN_SERVICE service database" declare desc="export a dump of the $PLUGIN_SERVICE service database"
local cmd="$PLUGIN_COMMAND_PREFIX:export" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:export" argv=("$@")

4
subcommands/expose
View File

@@ -7,9 +7,9 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-expose-cmd() { service-expose-cmd() {
#E expose the service on the service's normal ports, allowing access to it from the public interface (0.0.0.0) #E expose the service on the service's normal ports, allowing access to it from the public interface (0.0.0.0)
#E dokku $PLUGIN_COMMAND_PREFIX:expose lolipop ${PLUGIN_DATASTORE_PORTS[@]} #E dokku $PLUGIN_COMMAND_PREFIX:expose lollipop ${PLUGIN_DATASTORE_PORTS[@]}
#E expose the service on the service's normal ports, with the first on a specified ip adddress (127.0.0.1) #E expose the service on the service's normal ports, with the first on a specified ip adddress (127.0.0.1)
#E dokku $PLUGIN_COMMAND_PREFIX:expose lolipop 127.0.0.1:${PLUGIN_DATASTORE_PORTS[@]} #E dokku $PLUGIN_COMMAND_PREFIX:expose lollipop 127.0.0.1:${PLUGIN_DATASTORE_PORTS[@]}
#A service, service to run command against #A service, service to run command against
#A ports, a list of ports to run against #A ports, a list of ports to run against
declare desc="expose a $PLUGIN_SERVICE service on custom host:port if provided (random port on the 0.0.0.0 interface if otherwise unspecified)" declare desc="expose a $PLUGIN_SERVICE service on custom host:port if provided (random port on the 0.0.0.0 interface if otherwise unspecified)"

2
subcommands/import
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-import-cmd() { service-import-cmd() {
#E import a datastore dump #E import a datastore dump
#E dokku $PLUGIN_COMMAND_PREFIX:import lolipop < database.dump #E dokku $PLUGIN_COMMAND_PREFIX:import lollipop < database.dump
#A service, service to run command against #A service, service to run command against
declare desc="import a dump into the $PLUGIN_SERVICE service database" declare desc="import a dump into the $PLUGIN_SERVICE service database"
local cmd="$PLUGIN_COMMAND_PREFIX:import" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:import" argv=("$@")

22
subcommands/info
View File

@@ -7,18 +7,18 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-info-cmd() { service-info-cmd() {
#E get connection information as follows: #E get connection information as follows:
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop
#E you can also retrieve a specific piece of service info via flags: #E you can also retrieve a specific piece of service info via flags:
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --config-dir #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --config-dir
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --data-dir #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --data-dir
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --dsn #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --dsn
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --exposed-ports #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --exposed-ports
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --id #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --id
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --internal-ip #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --internal-ip
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --links #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --links
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --service-root #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --service-root
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --status #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --status
#E dokku $PLUGIN_COMMAND_PREFIX:info lolipop --version #E dokku $PLUGIN_COMMAND_PREFIX:info lollipop --version
#A service, service to run command against #A service, service to run command against
#F --config-dir, show the service configuration directory #F --config-dir, show the service configuration directory
#F --data-dir, show the service data directory #F --data-dir, show the service data directory

20
subcommands/link
View File

@@ -10,20 +10,20 @@ service-link-cmd() {
#E this will use native docker links via the docker-options plugin. #E this will use native docker links via the docker-options plugin.
#E here we link it to our 'playground' app. #E here we link it to our 'playground' app.
#E > NOTE: this will restart your app #E > NOTE: this will restart your app
#E dokku $PLUGIN_COMMAND_PREFIX:link lolipop playground #E dokku $PLUGIN_COMMAND_PREFIX:link lollipop playground
#E the following environment variables will be set automatically by docker #E the following environment variables will be set automatically by docker
#E (not on the app itself, so they won’t be listed when calling dokku config): #E (not on the app itself, so they won’t be listed when calling dokku config):
#E #E
#E DOKKU_${PLUGIN_VARIABLE}_LOLIPOP_NAME=/lolipop/DATABASE #E DOKKU_${PLUGIN_VARIABLE}_LOLLIPOP_NAME=/lollipop/DATABASE
#E DOKKU_${PLUGIN_VARIABLE}_LOLIPOP_PORT=tcp://172.17.0.1:${PLUGIN_DATASTORE_PORTS[0]} #E DOKKU_${PLUGIN_VARIABLE}_LOLLIPOP_PORT=tcp://172.17.0.1:${PLUGIN_DATASTORE_PORTS[0]}
#E DOKKU_${PLUGIN_VARIABLE}_LOLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP=tcp://172.17.0.1:${PLUGIN_DATASTORE_PORTS[0]} #E DOKKU_${PLUGIN_VARIABLE}_LOLLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP=tcp://172.17.0.1:${PLUGIN_DATASTORE_PORTS[0]}
#E DOKKU_${PLUGIN_VARIABLE}_LOLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP_PROTO=tcp #E DOKKU_${PLUGIN_VARIABLE}_LOLLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP_PROTO=tcp
#E DOKKU_${PLUGIN_VARIABLE}_LOLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP_PORT=${PLUGIN_DATASTORE_PORTS[0]} #E DOKKU_${PLUGIN_VARIABLE}_LOLLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP_PORT=${PLUGIN_DATASTORE_PORTS[0]}
#E DOKKU_${PLUGIN_VARIABLE}_LOLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP_ADDR=172.17.0.1 #E DOKKU_${PLUGIN_VARIABLE}_LOLLIPOP_PORT_${PLUGIN_DATASTORE_PORTS[0]}_TCP_ADDR=172.17.0.1
#E #E
#E the following will be set on the linked application by default: #E the following will be set on the linked application by default:
#E #E
#E ${PLUGIN_DEFAULT_ALIAS}_URL=${PLUGIN_SCHEME}://lolipop:SOME_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-lolipop:${PLUGIN_DATASTORE_PORTS[0]}/lolipop #E ${PLUGIN_DEFAULT_ALIAS}_URL=${PLUGIN_SCHEME}://lollipop:SOME_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-lollipop:${PLUGIN_DATASTORE_PORTS[0]}/lollipop
#E #E
#E the host exposed here only works internally in docker containers. #E the host exposed here only works internally in docker containers.
#E if you want your container to be reachable from outside, you should #E if you want your container to be reachable from outside, you should
@@ -34,10 +34,10 @@ service-link-cmd() {
#E after linking will cause the plugin to think the service is not #E after linking will cause the plugin to think the service is not
#E linked, and we advise you to unlink before proceeding. #E linked, and we advise you to unlink before proceeding.
#E dokku config:set playground ${PLUGIN_VARIABLE}_DATABASE_SCHEME=${PLUGIN_SCHEME}2 #E dokku config:set playground ${PLUGIN_VARIABLE}_DATABASE_SCHEME=${PLUGIN_SCHEME}2
#E dokku $PLUGIN_COMMAND_PREFIX:link lolipop playground #E dokku $PLUGIN_COMMAND_PREFIX:link lollipop playground
#E this will cause ${PLUGIN_DEFAULT_ALIAS}_URL to be set as: #E this will cause ${PLUGIN_DEFAULT_ALIAS}_URL to be set as:
#E #E
#E ${PLUGIN_SCHEME}2://lolipop:SOME_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-lolipop:${PLUGIN_DATASTORE_PORTS[0]}/lolipop #E ${PLUGIN_SCHEME}2://lollipop:SOME_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-lollipop:${PLUGIN_DATASTORE_PORTS[0]}/lollipop
#A service, service to run command against #A service, service to run command against
#A app, app to run command against #A app, app to run command against
#F -a|--alias "BLUE_DATABASE", an alternative alias to use for linking to an app via environment variable #F -a|--alias "BLUE_DATABASE", an alternative alias to use for linking to an app via environment variable

4
subcommands/linked
View File

@@ -6,8 +6,8 @@ source "$PLUGIN_BASE_PATH/common/functions"
source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions" source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-linked-cmd() { service-linked-cmd() {
#E here we check if the lolipop $PLUGIN_COMMAND_PREFIX service is linked to the 'playground' app. #E here we check if the lollipop $PLUGIN_COMMAND_PREFIX service is linked to the 'playground' app.
#E dokku $PLUGIN_COMMAND_PREFIX:linked lolipop playground #E dokku $PLUGIN_COMMAND_PREFIX:linked lollipop playground
#A service, service to run command against #A service, service to run command against
#A app, app to run command against #A app, app to run command against
declare desc="check if the $PLUGIN_SERVICE service is linked to an app" declare desc="check if the $PLUGIN_SERVICE service is linked to an app"

4
subcommands/links
View File

@@ -6,8 +6,8 @@ source "$PLUGIN_BASE_PATH/common/functions"
source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions" source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-links-cmd() { service-links-cmd() {
#E list all apps linked to the 'lolipop' $PLUGIN_COMMAND_PREFIX service. #E list all apps linked to the 'lollipop' $PLUGIN_COMMAND_PREFIX service.
#E dokku $PLUGIN_COMMAND_PREFIX:links lolipop #E dokku $PLUGIN_COMMAND_PREFIX:links lollipop
#A service, service to run command against #A service, service to run command against
declare desc="list all apps linked to the $PLUGIN_SERVICE service" declare desc="list all apps linked to the $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:links" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:links" argv=("$@")

4
subcommands/logs
View File

@@ -7,9 +7,9 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-logs-cmd() { service-logs-cmd() {
#E you can tail logs for a particular service: #E you can tail logs for a particular service:
#E dokku $PLUGIN_COMMAND_PREFIX:logs lolipop #E dokku $PLUGIN_COMMAND_PREFIX:logs lollipop
#E by default, logs will not be tailed, but you can do this with the --tail flag: #E by default, logs will not be tailed, but you can do this with the --tail flag:
#E dokku $PLUGIN_COMMAND_PREFIX:logs lolipop --tail #E dokku $PLUGIN_COMMAND_PREFIX:logs lollipop --tail
#A service, service to run command against #A service, service to run command against
#F -t|--tail, do not stop when end of the logs are reached and wait for additional output #F -t|--tail, do not stop when end of the logs are reached and wait for additional output
declare desc="print the most recent log(s) for this service" declare desc="print the most recent log(s) for this service"

2
subcommands/promote
View File

@@ -20,7 +20,7 @@ service-promote-cmd() {
#E #E
#E ${PLUGIN_DEFAULT_ALIAS}_URL=${PLUGIN_SCHEME}://other_service:ANOTHER_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-other-service:${PLUGIN_DATASTORE_PORTS[0]}/other_service #E ${PLUGIN_DEFAULT_ALIAS}_URL=${PLUGIN_SCHEME}://other_service:ANOTHER_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-other-service:${PLUGIN_DATASTORE_PORTS[0]}/other_service
#E DOKKU_${PLUGIN_DEFAULT_ALIAS}_BLUE_URL=${PLUGIN_SCHEME}://other_service:ANOTHER_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-other-service:${PLUGIN_DATASTORE_PORTS[0]}/other_service #E DOKKU_${PLUGIN_DEFAULT_ALIAS}_BLUE_URL=${PLUGIN_SCHEME}://other_service:ANOTHER_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-other-service:${PLUGIN_DATASTORE_PORTS[0]}/other_service
#E DOKKU_${PLUGIN_DEFAULT_ALIAS}_SILVER_URL=${PLUGIN_SCHEME}://lolipop:SOME_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-lolipop:${PLUGIN_DATASTORE_PORTS[0]}/lolipop #E DOKKU_${PLUGIN_DEFAULT_ALIAS}_SILVER_URL=${PLUGIN_SCHEME}://lollipop:SOME_PASSWORD@dokku-${PLUGIN_COMMAND_PREFIX}-lollipop:${PLUGIN_DATASTORE_PORTS[0]}/lollipop
#A service, service to run command against #A service, service to run command against
#A app, app to run command against #A app, app to run command against
declare desc="promote service <service> as ${PLUGIN_DEFAULT_ALIAS}_URL in <app>" declare desc="promote service <service> as ${PLUGIN_DEFAULT_ALIAS}_URL in <app>"

2
subcommands/restart
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-restart-cmd() { service-restart-cmd() {
#E restart the service #E restart the service
#E dokku $PLUGIN_COMMAND_PREFIX:restart lolipop #E dokku $PLUGIN_COMMAND_PREFIX:restart lollipop
#A service, service to run command against #A service, service to run command against
declare desc="graceful shutdown and restart of the $PLUGIN_SERVICE service container" declare desc="graceful shutdown and restart of the $PLUGIN_SERVICE service container"
local cmd="$PLUGIN_COMMAND_PREFIX:restart" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:restart" argv=("$@")

2
subcommands/start
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-start-cmd() { service-start-cmd() {
#E start the service #E start the service
#E dokku $PLUGIN_COMMAND_PREFIX:start lolipop #E dokku $PLUGIN_COMMAND_PREFIX:start lollipop
#A service, service to run command against #A service, service to run command against
declare desc="start a previously stopped $PLUGIN_SERVICE service" declare desc="start a previously stopped $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:start" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:start" argv=("$@")

2
subcommands/stop
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-stop-cmd() { service-stop-cmd() {
#E stop the service and the running container #E stop the service and the running container
#E dokku $PLUGIN_COMMAND_PREFIX:stop lolipop #E dokku $PLUGIN_COMMAND_PREFIX:stop lollipop
#A service, service to run command against #A service, service to run command against
declare desc="stop a running $PLUGIN_SERVICE service" declare desc="stop a running $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:stop" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:stop" argv=("$@")

2
subcommands/unexpose
View File

@@ -7,7 +7,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-unexpose-cmd() { service-unexpose-cmd() {
#E unexpose the service, removing access to it from the public interface (0.0.0.0) #E unexpose the service, removing access to it from the public interface (0.0.0.0)
#E dokku $PLUGIN_COMMAND_PREFIX:unexpose lolipop #E dokku $PLUGIN_COMMAND_PREFIX:unexpose lollipop
#A service, service to run command against #A service, service to run command against
declare desc="unexpose a previously exposed $PLUGIN_SERVICE service" declare desc="unexpose a previously exposed $PLUGIN_SERVICE service"
local cmd="$PLUGIN_COMMAND_PREFIX:unexpose" argv=("$@") local cmd="$PLUGIN_COMMAND_PREFIX:unexpose" argv=("$@")

2
subcommands/unlink
View File

@@ -8,7 +8,7 @@ source "$(dirname "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")/functions"
service-unlink-cmd() { service-unlink-cmd() {
#E you can unlink a $PLUGIN_COMMAND_PREFIX service #E you can unlink a $PLUGIN_COMMAND_PREFIX service
#E > NOTE: this will restart your app and unset related environment variables #E > NOTE: this will restart your app and unset related environment variables
#E dokku $PLUGIN_COMMAND_PREFIX:unlink lolipop playground #E dokku $PLUGIN_COMMAND_PREFIX:unlink lollipop playground
#A service, service to run command against #A service, service to run command against
#A app, app to run command against #A app, app to run command against
declare desc="unlink the $PLUGIN_SERVICE service from the app" declare desc="unlink the $PLUGIN_SERVICE service from the app"

2
subcommands/upgrade
View File

@@ -8,7 +8,7 @@ source "$PLUGIN_AVAILABLE_PATH/ps/functions"
service-upgrade-cmd() { service-upgrade-cmd() {
#E you can upgrade an existing service to a new image or image-version #E you can upgrade an existing service to a new image or image-version
#E dokku $PLUGIN_COMMAND_PREFIX:upgrade lolipop #E dokku $PLUGIN_COMMAND_PREFIX:upgrade lollipop
#A service, service to run command against #A service, service to run command against
#F -c|--config-options "--args --go=here", extra arguments to pass to the container create command #F -c|--config-options "--args --go=here", extra arguments to pass to the container create command
#F -C|--custom-env "USER=alpha;HOST=beta", semi-colon delimited environment variables to start the service with #F -C|--custom-env "USER=alpha;HOST=beta", semi-colon delimited environment variables to start the service with