b1ac7ac991
# History ## 0.10.0 ### Bug Fixes - #2820: @josegonzalez Require netcat in debian packaging - #2774: @fruitl00p Include docker-options in the default `dokku` - #2778: @zarqman Fix /etc/logrotate.d/dokku on debian - #2747: @ebeigarts Update herokuish base image on updates using --pull - #2739: @josegonzalez Use listener_port in nginx.conf.sigil - #2735: @josegonzalez Ensure we can call ps:report without specifying an application - #2733: @josegonzalez Add support for new docker package names - #2730: @weyert Ignore the cache directory when cloning an app - #2723: @weyert Call non-deprecated plugin:list method ### New Features - #2803: @iSDP Adding related articles on the Docker Image Deployment page - #2798: @znz Update CURL_CONNECT_TIMEOUT in docs - #2795: @josegonzalez docs: Add documentation around adding build-time configuration variables - #2791: @yazinsai Correct typo in persistent storage docs - #2789: @h4ckninja Subject-verb agreement - #2790: @flyinggrizzly Add entry for insecure connection issue in Rails - #2788: @josegonzalez Flesh out uninstallation documentation - #2784: @josegonzalez Document special dokku environment variables - #2773: @znz Update year in footer [ci skip] - #2768: @znz Ubuntu 12.04 is EOL - #2769: @lucianopf Fix SlackButton for mobile devices. - #2763: @ZiadSalah Update vagrant documentation for windows users - #2764: @joshmanders Create PULL_REQUEST_TEMPLATE.md - #2758: @AxelTheGerman Update doc location for dokku-git-rev community plugin - #2757: @nodanaonlyzuul Fix typo from "To use a dockerfiles" to "To use a dockerfile" singular - #2753: @abrkn Use short-hand method for shutting down all applications in upgrade docs - #2746: @josegonzalez Add redirect for installation to advanced install docs - #2738: @josegonzalez Add missing `NO_SSL_SERVER_NAME` to example template - #2457: @john-doherty Update Digitalocean installation instructions - #2725: @timaschew Fix typo in application management docs - #2719: @joshco Clarify that nginx.conf.sigil must be committed to repository - #2715: @josegonzalez Use urls that are linkable on github ### Documentation - #2822: @josegonzalez refactor: allow skipping cleanup on a per-application basis - #2754: @fzerorubigd Add support for set DOKKU_IMAGE per app - #2815: @markstory Add stickler-ci configuration. - #2809: @oliw Remove aufs step from Makefile - #2785: @josegonzalez Add a release-plugin binary - #2777: @stokarenko Turn on ps-post-stop hook. - #2781: @fruitl00p Adds docker.io support - #2766: @josegonzalez Upgrade to herokuish 0.3.29 - #2765: @josegonzalez Install python3-software-properties as an alternative to python-software-properties - #2642: @chiedo Added better default nginx error pages - #2678: @callahad Default to secure PCI-compliant SSL setup - #2734: @josegonzalez Allow quieter report output
4.3 KiB
4.3 KiB
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: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
# for 0.3.x
cd /var/lib/dokku/plugins
git clone <git url>
dokku plugins-install
These commands require
rootpermissions as theinstallandinstall-dependenciesplugin triggers may utilize commands such asapt-get. For non-core plugins, please inspect those plugins before running the following command asrootuser.
Usage
You can list all installed plugins using the plugin command:
dokku plugin
plugn: dev
00_dokku-standard 0.10.0 enabled dokku core standard plugin
20_events 0.10.0 enabled dokku core events logging plugin
apps 0.10.0 enabled dokku core apps plugin
build-env 0.10.0 enabled dokku core build-env plugin
certs 0.10.0 enabled dokku core certificate management plugin
checks 0.10.0 enabled dokku core checks plugin
common 0.10.0 enabled dokku core common plugin
config 0.10.0 enabled dokku core config plugin
docker-options 0.10.0 enabled dokku core docker-options plugin
domains 0.10.0 enabled dokku core domains plugin
enter 0.10.0 enabled dokku core enter plugin
git 0.10.0 enabled dokku core git plugin
logs 0.10.0 enabled dokku core logs plugin
named-containers 0.10.0 enabled dokku core named containers plugin
nginx-vhosts 0.10.0 enabled dokku core nginx-vhosts plugin
plugin 0.10.0 enabled dokku core plugin plugin
proxy 0.10.0 enabled dokku core proxy plugin
ps 0.10.0 enabled dokku core ps plugin
repo 0.10.0 enabled dokku core repo plugin
shell 0.10.0 enabled dokku core shell plugin
ssh-keys 0.10.0 enabled dokku core ssh-keys plugin
storage 0.10.0 enabled dokku core storage plugin
tags 0.10.0 enabled dokku core tags plugin
tar 0.10.0 enabled dokku core tar 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.
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:
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:
dokku plugin:disable postgres
-----> Plugin postgres disabled
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.
dokku plugin:update postgres
Plugin (postgres) updated