78621481a6
# History ## 0.19.0 Install/update via the bootstrap script: ```shell wget https://raw.githubusercontent.com/dokku/dokku/v0.19.0/bootstrap.sh sudo DOKKU_TAG=v0.19.0 bash bootstrap.sh ``` ### Bug Fixes - #3688: @josegonzalez Correct shfmt issues - #3684: @josegonzalez Do not push betafish releases to docker hub - #3681: @josegonzalez Proper openresty support ### New Features - #3687: @josegonzalez Add scheduler-post-run trigger - #3702: @josegonzalez Cleanup build and destroy logging output - #3693: @josegonzalez Remove ssh-keys user-auth trigger in favor of direct check in dokku binary - #3691: @josegonzalez Silence trigger logging - #3685: @josegonzalez Allow passing labels to one-off dokku containers - #3680: @josegonzalez Follow updated intermediate recommendations from the Mozilla SSL Config Generator - #3677: @josegonzalez Improve package build process - #3679: @josegonzalez Allow keeping the git directory during builds - #3577: @josegonzalez Use new-style docker management commands - #3678: @josegonzalez Add container-type to run and deploy containers - #3671: @josegonzalez Allow overriding checks doc url - #3662: @leshik Improve nginx ciphers compatibility - #3668: @josegonzalez Release latest docker image on release - #3659: @fzerorubigd Add support for grpc/grpcs port forwarding ### Documentation - #3701: @limenet Docs / Getting Started: use HTTPS instead of SSH for clone - #3699: @robhudson Add `dokku cleanup` to help output - #3669: @josegonzalez Fix reference to CHECKS file location ### Tests - #3670: @josegonzalez Upgrade all python test deps ### Other - #3690: @
120 lines
4.7 KiB
Markdown
120 lines
4.7 KiB
Markdown
# Plugin Management
|
|
|
|
> New as of 0.4.0
|
|
|
|
```
|
|
plugin:disable <name> # Disable an installed plugin (third-party only)
|
|
plugin:enable <name> # Enable a previously disabled plugin
|
|
plugin:install [--core|git-url [--committish tag|branch|commit|--name custom-plugin-name]] # Optionally download git-url (with custom tag/committish) & run install trigger for active plugins (or only core ones)
|
|
plugin:install-dependencies [--core] # Run install-dependencies trigger for active plugins (or only core ones)
|
|
plugin:list # Print active plugins
|
|
plugin:trigger <args...>. # Trigger an arbitrary plugin hook
|
|
plugin:uninstall <name> # Uninstall a plugin (third-party only)
|
|
plugin:update [name [committish]] # Optionally update named plugin from git (with custom tag/committish) & run update trigger for active plugins
|
|
```
|
|
|
|
```shell
|
|
# for 0.3.x
|
|
cd /var/lib/dokku/plugins
|
|
git clone <git url>
|
|
dokku plugins-install
|
|
```
|
|
|
|
> These commands require `root` permissions as the `install` and `install-dependencies` plugin triggers may utilize commands such as `apt-get`. For non-core plugins, please inspect those plugins before running the following command as `root` user.
|
|
|
|
## Usage
|
|
|
|
You can list all installed plugins using the `plugin:list` command:
|
|
|
|
```shell
|
|
dokku plugin:list
|
|
```
|
|
|
|
```
|
|
plugn: dev
|
|
00_dokku-standard 0.19.0 enabled dokku core standard plugin
|
|
20_events 0.19.0 enabled dokku core events logging plugin
|
|
app-json 0.19.0 enabled dokku core app-json plugin
|
|
apps 0.19.0 enabled dokku core apps plugin
|
|
build-env 0.19.0 enabled dokku core build-env plugin
|
|
buildpacks 0.19.0 enabled dokku core buildpacks plugin
|
|
certs 0.19.0 enabled dokku core certificate management plugin
|
|
checks 0.19.0 enabled dokku core checks plugin
|
|
common 0.19.0 enabled dokku core common plugin
|
|
config 0.19.0 enabled dokku core config plugin
|
|
docker-options 0.19.0 enabled dokku core docker-options plugin
|
|
domains 0.19.0 enabled dokku core domains plugin
|
|
enter 0.19.0 enabled dokku core enter plugin
|
|
git 0.19.0 enabled dokku core git plugin
|
|
logs 0.19.0 enabled dokku core logs plugin
|
|
network 0.19.0 enabled dokku core network plugin
|
|
nginx-vhosts 0.19.0 enabled dokku core nginx-vhosts plugin
|
|
plugin 0.19.0 enabled dokku core plugin plugin
|
|
proxy 0.19.0 enabled dokku core proxy plugin
|
|
ps 0.19.0 enabled dokku core ps plugin
|
|
repo 0.19.0 enabled dokku core repo plugin
|
|
resource 0.19.0 enabled dokku core resource plugin
|
|
scheduler-docker-local 0.19.0 enabled dokku core scheduler-docker-local plugin
|
|
shell 0.19.0 enabled dokku core shell plugin
|
|
ssh-keys 0.19.0 enabled dokku core ssh-keys plugin
|
|
storage 0.19.0 enabled dokku core storage plugin
|
|
tags 0.19.0 enabled dokku core tags plugin
|
|
tar 0.19.0 enabled dokku core tar plugin
|
|
trace 0.19.0 enabled dokku core trace plugin
|
|
```
|
|
|
|
Installing a plugin is easy as well using the `plugin:install` command. This command will also trigger the `install` pluginhook on all existing plugins.
|
|
|
|
```shell
|
|
dokku plugin:install https://github.com/dokku/dokku-postgres.git
|
|
```
|
|
|
|
```
|
|
-----> Cloning plugin repo https://github.com/dokku/dokku-postgres.git to /var/lib/dokku/plugins/available/postgres
|
|
Cloning into 'postgres'...
|
|
remote: Counting objects: 646, done.
|
|
remote: Total 646 (delta 0), reused 0 (delta 0), pack-reused 646
|
|
Receiving objects: 100% (646/646), 134.24 KiB | 0 bytes/s, done.
|
|
Resolving deltas: 100% (406/406), done.
|
|
Checking connectivity... done.
|
|
-----> Plugin postgres enabled
|
|
```
|
|
|
|
You can also uninstall a third-party plugin using the `plugin:uninstall` command:
|
|
|
|
```shell
|
|
dokku plugin:uninstall postgres
|
|
```
|
|
|
|
```
|
|
-----> Plugin postgres uninstalled
|
|
```
|
|
|
|
Enabling or disabling a plugin can also be useful in cases where you are debugging whether a third-party plugin is causing issues in your Dokku installation:
|
|
|
|
```shell
|
|
dokku plugin:disable postgres
|
|
```
|
|
|
|
```
|
|
-----> Plugin postgres disabled
|
|
```
|
|
|
|
```shell
|
|
dokku plugin:enable postgres
|
|
```
|
|
|
|
```
|
|
-----> Plugin postgres enabled
|
|
```
|
|
|
|
Finally, you can update an installed third-party plugin. This should be done after any upgrades of Dokku as there may be changes in the internal api that require an update of how the plugin interfaces with Dokku.
|
|
|
|
```shell
|
|
dokku plugin:update postgres
|
|
```
|
|
|
|
```
|
|
Plugin (postgres) updated
|
|
```
|