diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index 1f9ff247b..0fbe65462 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -54,7 +54,7 @@ jobs: - name: Clone uses: actions/checkout@v3 - name: Run shfmt - uses: luizm/action-sh-checker@38985be9e872ef709f8ffca07af3ff88572fe429 + uses: luizm/action-sh-checker@edd0e45ecff35b05f162052b50df50976c1b74fc # v0.3.0 => 7f44869033b40ee4ffe7dc76c87a1bc66e3d025a env: SHFMT_OPTS: -l -bn -ci -i 2 -d diff --git a/HISTORY.md b/HISTORY.md index 9e21898f4..66bda701b 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -1,5 +1,85 @@ # History +## 0.27.8 + +Install/update via the bootstrap script: + +```shell +wget https://raw.githubusercontent.com/dokku/dokku/v0.27.8/bootstrap.sh +sudo DOKKU_TAG=v0.27.8 bash bootstrap.sh +``` + +### Bug Fixes + +- #5232: @YuukiHogo builder-build fix for DOKKU_DOCKERFILE_CACHE_BUILD and DOKKU_DOCKER_BUILD_OPTS variables + +### New Features + +- #5255: @josegonzalez export DOKKU_COMMAND for use in authentication systems + +### Other + +- #5250: @dependabot[bot] chore(deps): bump flask from 2.1.2 to 2.1.3 in /tests/apps/multi +- #5251: @dependabot[bot] chore(deps): bump flask from 2.1.2 to 2.1.3 in /tests/apps/python-flask +- #5245: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 221 to 222 in /tests/apps/php + +## 0.27.7 + +Install/update via the bootstrap script: + +```shell +wget https://raw.githubusercontent.com/dokku/dokku/v0.27.7/bootstrap.sh +sudo DOKKU_TAG=v0.27.7 bash bootstrap.sh +``` + +### Bug Fixes + +- #5238: @josegonzalez Respect dokku system user/group when setting storage permissions on installation + +### New Features + +- #5239: @josegonzalez Add builder-type and image-stage labels to all images + +### Documentation + +- #5241: @josegonzalez Clarify where logs are pulled from and general log shipping stance +- #5237: @josegonzalez Fix builder-pack:set command example + +### Other + +- #5235: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 220 to 221 in /tests/apps/php + +## 0.27.6 + +Install/update via the bootstrap script: + +```shell +wget https://raw.githubusercontent.com/dokku/dokku/v0.27.6/bootstrap.sh +sudo DOKKU_TAG=v0.27.6 bash bootstrap.sh +``` + +### Bug Fixes + +- #5225: @josegonzalez Use original app name when setting include_labels for vector source +- #5228: @josegonzalez Always respect app.json formations in scale settings +- #5201: @josegonzalez Use pack as default builder for arm64 servers + +### Documentation + +- #5230: @josegonzalez Clarify usage of build args to set environment variables for Dockerfile deploys +- #5208: @asokoloski-m Fix typo in dockerfile builder docs +- #5206: @AxelTheGerman Added dokku-litestream to list of community plugins + +### Other + +- #5218: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 219 to 220 in /tests/apps/php +- #5222: @dependabot[bot] chore(deps): bump jetty-servlet from 11.0.10 to 11.0.11 in /tests/apps/java +- #5224: @josegonzalez Document that the community registry plugin should be uninstalled before upgrading past 0.24.x +- #5220: @dependabot[bot] chore(deps): bump jetty-servlet from 11.0.9 to 11.0.10 in /tests/apps/java +- #5212: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 218 to 219 in /tests/apps/php +- #5210: @dependabot[bot] chore(deps): bump monolog/monolog from 1.27.0 to 1.27.1 in /tests/apps/php +- #5204: @dependabot[bot] chore(deps-dev): bump heroku/heroku-buildpack-php from 217 to 218 in /tests/apps/php + ## 0.27.5 Install/update via the bootstrap script: diff --git a/README.md b/README.md index 003c835af..3b3c89c12 100644 --- a/README.md +++ b/README.md @@ -87,8 +87,8 @@ Otherwise, you will need to import the keypair manually after installation using To install the latest stable release, run the following commands as a user who has access to `sudo`: ```shell -wget https://raw.githubusercontent.com/dokku/dokku/v0.27.5/bootstrap.sh -sudo DOKKU_TAG=v0.27.5 bash bootstrap.sh +wget https://raw.githubusercontent.com/dokku/dokku/v0.27.8/bootstrap.sh +sudo DOKKU_TAG=v0.27.8 bash bootstrap.sh ``` You can then proceed to configure your server domain (via `dokku domains:set-global`) and user access (via `dokku ssh-keys:add`) to complete the installation. diff --git a/bootstrap.sh b/bootstrap.sh index dac9ee095..97f4d1113 100755 --- a/bootstrap.sh +++ b/bootstrap.sh @@ -212,7 +212,7 @@ install-dokku-from-deb-package() { fi echo "--> Installing dokku" - wget -nv -O - https://packagecloud.io/dokku/dokku/gpgkey | apt-key add - + wget -qO- https://packagecloud.io/dokku/dokku/gpgkey | sudo tee /etc/apt/trusted.gpg.d/dokku.asc echo "deb https://packagecloud.io/dokku/dokku/$DOKKU_DISTRO/ $OS_ID main" | tee /etc/apt/sources.list.d/dokku.list apt-get update -qq >/dev/null diff --git a/deb.mk b/deb.mk index 9d1382bb6..635ab036f 100644 --- a/deb.mk +++ b/deb.mk @@ -19,7 +19,7 @@ install-from-deb: wget -nv -O - https://get.docker.com/ | sh @echo "--> Installing dokku" - wget -nv -O - https://packagecloud.io/dokku/dokku/gpgkey | apt-key add - + wget -qO- https://packagecloud.io/dokku/dokku/gpgkey | sudo tee /etc/apt/trusted.gpg.d/dokku.asc @echo "deb https://packagecloud.io/dokku/dokku/ubuntu/ $(shell lsb_release -cs 2>/dev/null || echo "bionic") main" | sudo tee /etc/apt/sources.list.d/dokku.list sudo apt-get update -qq >/dev/null sudo DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true apt-get -qq -y --no-install-recommends install dokku diff --git a/debian/control b/debian/control index bace8b72d..62eb5d2c5 100644 --- a/debian/control +++ b/debian/control @@ -1,5 +1,5 @@ Package: dokku -Version: 0.27.5 +Version: 0.27.8 Section: web Priority: optional Architecture: amd64 diff --git a/docs/advanced-usage/plugin-management.md b/docs/advanced-usage/plugin-management.md index 3bb5d428e..6f701b41f 100644 --- a/docs/advanced-usage/plugin-management.md +++ b/docs/advanced-usage/plugin-management.md @@ -35,35 +35,35 @@ dokku plugin:list ``` plugn: dev - 00_dokku-standard 0.27.5 enabled dokku core standard plugin - 20_events 0.27.5 enabled dokku core events logging plugin - app-json 0.27.5 enabled dokku core app-json plugin - apps 0.27.5 enabled dokku core apps plugin - build-env 0.27.5 enabled dokku core build-env plugin - buildpacks 0.27.5 enabled dokku core buildpacks plugin - certs 0.27.5 enabled dokku core certificate management plugin - checks 0.27.5 enabled dokku core checks plugin - common 0.27.5 enabled dokku core common plugin - config 0.27.5 enabled dokku core config plugin - docker-options 0.27.5 enabled dokku core docker-options plugin - domains 0.27.5 enabled dokku core domains plugin - enter 0.27.5 enabled dokku core enter plugin - git 0.27.5 enabled dokku core git plugin - logs 0.27.5 enabled dokku core logs plugin - network 0.27.5 enabled dokku core network plugin - nginx-vhosts 0.27.5 enabled dokku core nginx-vhosts plugin - plugin 0.27.5 enabled dokku core plugin plugin - proxy 0.27.5 enabled dokku core proxy plugin - ps 0.27.5 enabled dokku core ps plugin - repo 0.27.5 enabled dokku core repo plugin - resource 0.27.5 enabled dokku core resource plugin - scheduler-docker-local 0.27.5 enabled dokku core scheduler-docker-local plugin - shell 0.27.5 enabled dokku core shell plugin - ssh-keys 0.27.5 enabled dokku core ssh-keys plugin - storage 0.27.5 enabled dokku core storage plugin - tags 0.27.5 enabled dokku core tags plugin - tar 0.27.5 enabled dokku core tar plugin - trace 0.27.5 enabled dokku core trace plugin + 00_dokku-standard 0.27.8 enabled dokku core standard plugin + 20_events 0.27.8 enabled dokku core events logging plugin + app-json 0.27.8 enabled dokku core app-json plugin + apps 0.27.8 enabled dokku core apps plugin + build-env 0.27.8 enabled dokku core build-env plugin + buildpacks 0.27.8 enabled dokku core buildpacks plugin + certs 0.27.8 enabled dokku core certificate management plugin + checks 0.27.8 enabled dokku core checks plugin + common 0.27.8 enabled dokku core common plugin + config 0.27.8 enabled dokku core config plugin + docker-options 0.27.8 enabled dokku core docker-options plugin + domains 0.27.8 enabled dokku core domains plugin + enter 0.27.8 enabled dokku core enter plugin + git 0.27.8 enabled dokku core git plugin + logs 0.27.8 enabled dokku core logs plugin + network 0.27.8 enabled dokku core network plugin + nginx-vhosts 0.27.8 enabled dokku core nginx-vhosts plugin + plugin 0.27.8 enabled dokku core plugin plugin + proxy 0.27.8 enabled dokku core proxy plugin + ps 0.27.8 enabled dokku core ps plugin + repo 0.27.8 enabled dokku core repo plugin + resource 0.27.8 enabled dokku core resource plugin + scheduler-docker-local 0.27.8 enabled dokku core scheduler-docker-local plugin + shell 0.27.8 enabled dokku core shell plugin + ssh-keys 0.27.8 enabled dokku core ssh-keys plugin + storage 0.27.8 enabled dokku core storage plugin + tags 0.27.8 enabled dokku core tags plugin + tar 0.27.8 enabled dokku core tar plugin + trace 0.27.8 enabled dokku core trace plugin ``` > Warning: All plugin commands other than `plugin:list` and `plugin:help` require sudo access and must be run directly from the Dokku server. diff --git a/docs/appendices/0.25.0-migration-guide.md b/docs/appendices/0.25.0-migration-guide.md index 0730217db..95c74490a 100644 --- a/docs/appendices/0.25.0-migration-guide.md +++ b/docs/appendices/0.25.0-migration-guide.md @@ -9,6 +9,8 @@ The [dokku-registry](https://github.com/dokku/dokku-registry) plugin is now buil - At this time, remote docker repositories are not automatically created for AWS, and users must create those repositories for their applications as necessary. This may be implemented in the future. - Docker images are only pushed when configured to do so. See the [registry management documentation](/docs/deployment/registry-management.md) for more details. +Before upgrading, uninstall the registry plugin via `dokku plugin:uninstall registry`. Not doing so will cause issues with Dokku. + ## Other ### Changes diff --git a/docs/assets/favicons/browserconfig.xml b/docs/assets/favicons/browserconfig.xml index 506727caf..5dbb41aae 100644 --- a/docs/assets/favicons/browserconfig.xml +++ b/docs/assets/favicons/browserconfig.xml @@ -2,10 +2,10 @@ - - - - + + + + #da532c diff --git a/docs/assets/favicons/manifest.json b/docs/assets/favicons/manifest.json index d4cae553e..37b96bcb4 100644 --- a/docs/assets/favicons/manifest.json +++ b/docs/assets/favicons/manifest.json @@ -2,37 +2,37 @@ "name": "Dokku", "icons": [ { - "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.5\/docs\/assets\/favicons\/android-chrome-36x36.png", + "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.8\/docs\/assets\/favicons\/android-chrome-36x36.png", "sizes": "36x36", "type": "image\/png", "density": "0.75" }, { - "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.5\/docs\/assets\/favicons\/android-chrome-48x48.png", + "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.8\/docs\/assets\/favicons\/android-chrome-48x48.png", "sizes": "48x48", "type": "image\/png", "density": "1.0" }, { - "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.5\/docs\/assets\/favicons\/android-chrome-72x72.png", + "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.8\/docs\/assets\/favicons\/android-chrome-72x72.png", "sizes": "72x72", "type": "image\/png", "density": "1.5" }, { - "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.5\/docs\/assets\/favicons\/android-chrome-96x96.png", + "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.8\/docs\/assets\/favicons\/android-chrome-96x96.png", "sizes": "96x96", "type": "image\/png", "density": "2.0" }, { - "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.5\/docs\/assets\/favicons\/android-chrome-144x144.png", + "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.8\/docs\/assets\/favicons\/android-chrome-144x144.png", "sizes": "144x144", "type": "image\/png", "density": "3.0" }, { - "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.5\/docs\/assets\/favicons\/android-chrome-192x192.png", + "src": "https:\/\/cdn.jsdelivr.net\/dokku\/dokku@v0.27.8\/docs\/assets\/favicons\/android-chrome-192x192.png", "sizes": "192x192", "type": "image\/png", "density": "4.0" diff --git a/docs/assets/style.css b/docs/assets/style.css index fa635d00f..e2cbaa671 100644 --- a/docs/assets/style.css +++ b/docs/assets/style.css @@ -81,6 +81,7 @@ a:hover>.cta-arrow .cta-arrow__tip { .navbar-toggler:focus { border: none; box-shadow: none; + } .navbar-brand { diff --git a/docs/assets/versions.json b/docs/assets/versions.json index dd671dbd9..b15b9d140 100644 --- a/docs/assets/versions.json +++ b/docs/assets/versions.json @@ -24,6 +24,6 @@ "0.24.10", "0.25.7", "0.26.8", - "0.27.5" + "0.27.8" ] } diff --git a/docs/community/plugins.md b/docs/community/plugins.md index aa3301d05..65f7a6bb5 100644 --- a/docs/community/plugins.md +++ b/docs/community/plugins.md @@ -102,6 +102,7 @@ The following plugins are available and provided by Dokku maintainers. Please f | [Haproxy tcp load balancer](https://github.com/256dpi/dokku-haproxy) | [256dpi][] | 0.4.0+ | | [Hostname](https://github.com/michaelshobbs/dokku-hostname) | [michaelshobbs][] | 0.4.0+ | | [HTTP Auth Secure Apps](https://github.com/matto1990/dokku-secure-apps) | [matto1990][] | 0.4.0+ | +| [Litestream](https://github.com/AxelTheGerman/dokku-litestream)2 | [AxelTheGerman][] | 0.27.0+ | | [Monit (Health Checks)](https://github.com/mbreit/dokku-monit) | [mbreit][] | 0.8.0+ | | [Nuke Containers](https://github.com/josegonzalez/dokku-nuke) | [josegonzalez][] | 0.4.0+ | | [Open App Ports](https://github.com/josegonzalez/dokku-ports) | [josegonzalez][] | 0.3.x | @@ -116,13 +117,15 @@ The following plugins are available and provided by Dokku maintainers. Please f 1 Extends app.json support to include creating volumes and creating / linking databases on push -2 Adds the possibility to add SSH deployment keys to receive private hosted packages +2 Adds SQLite replication to external object storage via [Litestream](https://litestream.io) -3 Adds the ability to add custom hosts to the containers known_hosts file to be able to ssh them easily (useful with deployment keys) +3 Adds the possibility to add SSH deployment keys to receive private hosted packages -4 Adds the ability to sync an application repo with a remote GitHub repo (useful for automated rebuilds without needing a git push from an external system +4 Adds the ability to add custom hosts to the containers known_hosts file to be able to ssh them easily (useful with deployment keys) -5 Adds the ability to invoke a post-deploy webhook with the IP, port and app name, all with a single config:set). +5 Adds the ability to sync an application repo with a remote GitHub repo (useful for automated rebuilds without needing a git push from an external system + +6 Adds the ability to invoke a post-deploy webhook with the IP, port and app name, all with a single config:set). ### Other Plugins @@ -238,6 +241,7 @@ The following plugins are no longer maintained by their developers. [aomitayo]: https://github.com/aomitayo [apmorton]: https://github.com/apmorton [artofrawr]: https://github.com/artofrawr +[AxelTheGerman]: https://github.com/AxelTheGerman [badsyntax]: https://github.com/badsyntax [basgys]: https://github.com/basgys [benjamin-dobell]: https://github.com/benjamin-dobell diff --git a/docs/configuration/environment-variables.md b/docs/configuration/environment-variables.md index 2914a6d03..bb078ec93 100644 --- a/docs/configuration/environment-variables.md +++ b/docs/configuration/environment-variables.md @@ -14,7 +14,7 @@ config:keys (|--global) [--merged] config:set [--encoded] [--no-restart] (|--global) KEY1=VALUE1 [KEY2=VALUE2 ...] Set one or more config vars config:unset [--no-restart] (|--global) KEY1 [KEY2 ...] Unset one or more config vars ``` -> For security reasons - and as per [docker recommendations](https://github.com/docker/docker/issues/13490) - Dockerfile-based deploys have variables available _only_ during runtime, as noted in [this issue](https://github.com/dokku/dokku/issues/1860). +> For security reasons - and as per [docker recommendations](https://github.com/docker/docker/issues/13490) - Dockerfile-based deploys have variables available _only_ during runtime, as noted in [this issue](https://github.com/dokku/dokku/issues/1860). Consider using [build arguments](/docs/deployment/builders/dockerfiles.md#build-time-configuration-variables) to expose variables during build-time for Dockerfile apps. Environment variables are available both at run time and during the application build/compilation step for buildpack-based deploys. diff --git a/docs/deployment/builders/cloud-native-buildpacks.md b/docs/deployment/builders/cloud-native-buildpacks.md index 572a6d2c4..ebbb15768 100644 --- a/docs/deployment/builders/cloud-native-buildpacks.md +++ b/docs/deployment/builders/cloud-native-buildpacks.md @@ -84,7 +84,7 @@ dokku builder-pack:set --global projecttoml-path You can get a report about the app's storage status using the `builder-pack:report` command: ```shell -dokku app-json:report +dokku builder-pack:report ``` ``` diff --git a/docs/deployment/builders/dockerfiles.md b/docs/deployment/builders/dockerfiles.md index 841e79e2a..66a6adeb8 100644 --- a/docs/deployment/builders/dockerfiles.md +++ b/docs/deployment/builders/dockerfiles.md @@ -62,7 +62,7 @@ dokku builder-dockerfile:set --global dockerfile-path You can get a report about the app's storage status using the `builder-dockerfile:report` command: ```shell -dokku app-json:report +dokku builder-dockerfile:report ``` ``` diff --git a/docs/deployment/logs.md b/docs/deployment/logs.md index 1271ddde6..f4f2ce66c 100644 --- a/docs/deployment/logs.md +++ b/docs/deployment/logs.md @@ -20,6 +20,8 @@ You can easily get logs of an app using the `logs` command: dokku logs node-js-app ``` +Logs are pulled via integration with the scheduler for the specified application via "live tailing". As such, logs from previously running deployments are usually not available. Users that desire to see logs from previous deployments for debugging purposes should persist those logs to external services. Please see Dokku's [vector integration](deployment/logs.md#vector-logging-shipping) for more information on how to persist logs across deployments to ship logs to another service or a third-party platform. + #### Behavioral modifiers Dokku also supports certain command-line arguments that augment the `log` command's behavior. diff --git a/docs/deployment/schedulers/docker-local.md b/docs/deployment/schedulers/docker-local.md index df2048f78..5d50da590 100644 --- a/docs/deployment/schedulers/docker-local.md +++ b/docs/deployment/schedulers/docker-local.md @@ -91,7 +91,11 @@ Omitting or removing the entry will result in parallelism for that process type Note that increasing the value of `max_parallel` may significantly impact CPU utilization on your host as your app containers - and their respective processes - start up. Setting a value higher than the number of available CPUs is discouraged. It is recommended that users carefully set this value so as not to overburden their server. -## Implemented Triggers +## Scheduler Interface + +The following sections describe implemented scheduler functionality for the `docker-local` scheduler. + +### Implemented Commands and Triggers This plugin implements various functionality through `plugn` triggers to integrate with Docker for running apps on a single server. The following functionality is supported by the `scheduler-docker-local` plugin. @@ -105,11 +109,16 @@ This plugin implements various functionality through `plugn` triggers to integra - `ps:stop` - `run` -## Supported Resource Management Properties + +### Logging support + +App logs for the `logs` command are fetched from running containers via the `docker` cli. To persist logs across deployments, consider using Dokku's [vector integration](deployment/logs.md#vector-logging-shipping) to ship logs to another service or a third-party platform. + +### Supported Resource Management Properties The `docker-local` scheduler supports a minimal list of resource _limits_ and _reservations_. The following properties are supported: -### Resource Limits +#### Resource Limits - cpu: (docker option: `--cpus`), is specified in number of CPUs a process can access. - See the ["CPU" section](https://docs.docker.com/config/containers/resource_constraints/#cpu) of the Docker Runtime Options documentation for more information. @@ -120,7 +129,7 @@ The `docker-local` scheduler supports a minimal list of resource _limits_ and _r - nvidia-gpus: (docker option: `--gpus`), is specified in number of Nvidia GPUs a process can access. - See the ["GPU" section](https://docs.docker.com/config/containers/resource_constraints/#gpu) of the Docker Runtime Options documentation for more information. -### Resource Reservations +#### Resource Reservations - memory: (docker option: `--memory-reservation`) should be specified with a suffix of `b` (bytes), `k` (kilobytes), `m` (megabytes), `g` (gigabytes). Default unit is `m` (megabytes). - See the ["Memory" section](https://docs.docker.com/config/containers/resource_constraints/#memory) of the Docker Runtime Options documentation for more information. diff --git a/docs/deployment/schedulers/kubernetes.md b/docs/deployment/schedulers/kubernetes.md index 245f5857d..1d945bf88 100644 --- a/docs/deployment/schedulers/kubernetes.md +++ b/docs/deployment/schedulers/kubernetes.md @@ -2,13 +2,23 @@ > Warning: This scheduler is not in Dokku core and thus functionality may change over time as the API stabilizes. -The [Kubernetes Scheduler Plugin](https://github.com/dokku/dokku-scheduler-kubernetes) implements the following functionality: +The [Nomad Scheduler Plugin](https://github.com/dokku/dokku-scheduler-kubernetes) is available free as an external plugin. Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-kubernetes/issues) for more information on the status of the plugin. + +For users that require additional functionality, please refer to the [Sponsoring Documentation](https://github.com/dokku/.github/blob/master/SPONSORING.md). + +## Scheduler Interface + +The following sections describe implemented scheduler functionality for the `docker-local` scheduler. + +### Implemented Commands and Triggers + +This plugin implements various functionality through `plugn` triggers to integrate with `kubectl` for running apps on a Kubernetes cluster. The following functionality is supported by the `scheduler-kubernetes` plugin. - `apps:destroy` - `deploy`: partial, does not implement failed deploy log capture - `logs`: partial, does not implement failure logs - `ps:stop` -Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-kubernetes/issues) for more information on the status of the plugin. +### Logging support -For users that require additional functionality, please refer to the [Sponsoring Documentation](https://github.com/dokku/.github/blob/master/SPONSORING.md). +App logs for the `logs` command are fetched from running pods via the `kubectl` cli. To persist logs across deployments, consider using [Vector](https://vector.dev/docs/setup/installation/platforms/kubernetes/) or a similar tool to ship logs to another service or a third-party platform. diff --git a/docs/deployment/schedulers/nomad.md b/docs/deployment/schedulers/nomad.md index 380f92875..e043db3a9 100644 --- a/docs/deployment/schedulers/nomad.md +++ b/docs/deployment/schedulers/nomad.md @@ -2,12 +2,22 @@ > Warning: This scheduler is not in Dokku core and thus functionality may change over time as the API stabilizes. -The [Nomad Scheduler Plugin](https://github.com/dokku/dokku-scheduler-nomad) implements the following functionality: +The [Nomad Scheduler Plugin](https://github.com/dokku/dokku-scheduler-nomad) is available free as an external plugin. Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-nomad/issues) for more information on the status of the plugin. + +For users that require additional functionality, please refer to the [Sponsoring Documentation](https://github.com/dokku/.github/blob/master/SPONSORING.md). + +## Scheduler Interface + +The following sections describe implemented scheduler functionality for the `docker-local` scheduler. + +### Implemented Commands and Triggers + +This plugin implements various functionality through `plugn` triggers to integrate with the `nomad` cli for running apps on a Nomad cluster. The following functionality is supported by the `scheduler-nomad` plugin. - `apps:destroy` - `deploy` - `ps:stop` -Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-nomad/issues) for more information on the status of the plugin. +### Logging support -For users that require additional functionality, please refer to the [Sponsoring Documentation](https://github.com/dokku/.github/blob/master/SPONSORING.md). +> Warning: Fetching app logs for the `logs` command is currently not implemented. Please consider using [Vector](https://vector.dev/docs/setup/installation/platforms/kubernetes/) or a similar tool to ship logs to another service or a third-party platform. diff --git a/docs/development/release-process.md b/docs/development/release-process.md index a9a316814..d2253708b 100644 --- a/docs/development/release-process.md +++ b/docs/development/release-process.md @@ -29,7 +29,7 @@ The workflow looks like this: ```shell # having dokku-arch in ../dokku-arch vagrant up build-arch -# wait for "==> build-arch: ==> Finished making: dokku 0.27.5-2 (Mon Feb 22 23:20:37 CET 2016)" +# wait for "==> build-arch: ==> Finished making: dokku 0.27.8-2 (Mon Feb 22 23:20:37 CET 2016)" cd ../dokku-arch git add PKGBUILD .SRCINFO git commit -m 'Update to dokku 0.9.9' diff --git a/docs/getting-started/install/debian.md b/docs/getting-started/install/debian.md index dfc0e093e..e0c39e019 100644 --- a/docs/getting-started/install/debian.md +++ b/docs/getting-started/install/debian.md @@ -11,7 +11,7 @@ sudo apt-get -qq -y --no-install-recommends install apt-transport-https wget -nv -O - https://get.docker.com/ | sh # install dokku -wget -nv -O - https://packagecloud.io/dokku/dokku/gpgkey | apt-key add - +wget -qO- https://packagecloud.io/dokku/dokku/gpgkey | sudo tee /etc/apt/trusted.gpg.d/dokku.asc OS_ID="$(lsb_release -cs 2>/dev/null || echo "bionic")" echo "bionic focal jammy" | grep -q "$OS_ID" || OS_ID="bionic" echo "deb https://packagecloud.io/dokku/dokku/ubuntu/ ${OS_ID} main" | sudo tee /etc/apt/sources.list.d/dokku.list diff --git a/docs/getting-started/install/docker.md b/docs/getting-started/install/docker.md index 006f8c4b3..339e6d8ee 100644 --- a/docs/getting-started/install/docker.md +++ b/docs/getting-started/install/docker.md @@ -3,7 +3,7 @@ Pull the dokku/dokku image: ```shell -docker pull dokku/dokku:0.27.5 +docker pull dokku/dokku:0.27.8 ``` Next, run the image. @@ -18,7 +18,7 @@ docker container run \ --publish 8443:443 \ --volume /var/lib/dokku:/mnt/dokku \ --volume /var/run/docker.sock:/var/run/docker.sock \ - dokku/dokku:0.27.5 + dokku/dokku:0.27.8 ``` The above command will start a new docker container that is ready when a message similar to `Runit started as PID 12345` appears. diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index 0d787a9ab..1d4729f6d 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -39,8 +39,8 @@ To install the latest stable version of Dokku, you can run the following shell c ```shell # for debian systems, installs Dokku via apt-get -wget https://raw.githubusercontent.com/dokku/dokku/v0.27.5/bootstrap.sh; -sudo DOKKU_TAG=v0.27.5 bash bootstrap.sh +wget https://raw.githubusercontent.com/dokku/dokku/v0.27.8/bootstrap.sh; +sudo DOKKU_TAG=v0.27.8 bash bootstrap.sh ``` The installation process takes about 5-10 minutes, depending upon internet connection speed. diff --git a/docs/home.html b/docs/home.html index 52b5e18d2..53d162c82 100644 --- a/docs/home.html +++ b/docs/home.html @@ -10,26 +10,26 @@ Dokku - The smallest PaaS implementation you've ever seen - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - + + @@ -38,11 +38,8 @@ - + - @@ -127,7 +124,7 @@

$ - sudo DOKKU_TAG=v0.27.4 bash bootstrap.sh + sudo DOKKU_TAG=v0.27.8 bash bootstrap.sh


diff --git a/docs/template.html b/docs/template.html index 9f4cbdf9c..8e7bac41f 100644 --- a/docs/template.html +++ b/docs/template.html @@ -9,26 +9,26 @@ Dokku - {{DOC_TITLE}} - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - + +