Document caveats around ps:rebuild and tags/tar deployed applications. Closes #2374

The tags and tar plugins do not necessarily build from source, and running `ps:rebuild` can have some unexpected output in certain cases. Rather than try to handle that complexity - it's a lot - documenting the edge cases is the most appropriate way forward.
This commit is contained in:
Jose Diaz-Gonzalez
2016-09-06 20:26:53 -04:00
parent 0841888b67
commit 7ccfdabc48
7 changed files with 38 additions and 9 deletions

View File

@@ -27,9 +27,19 @@ sudo apt-get update
dokku apps
dokku ps:stop <app> # repeat to shut down each running app
sudo apt-get install -qq -y dokku herokuish
dokku ps:rebuildall # restart all applications
dokku ps:rebuildall # rebuilds all applications
```
> If you have any applications deployed via the `tags` or `tar` commands, do not run the `ps:rebuildall` command,
> and instead trigger `ps:rebuild` manually for each `git`-deployed application:
>
> ```
> dokku ps:rebuild APP
> ```
>
> Please see the [images documentation](/dokku/deployment/methods/images/) and [tar documentation](/dokku/deployment/methods/tar/)
> for instructions on rebuilding applications deployed by those plugins.
### Upgrade From Source
If you installed Dokku from source (less common), upgrade with:
@@ -45,7 +55,7 @@ sudo DOKKU_BRANCH=master make install
# upgrade to debian package-based installation
sudo make install
dokku ps:rebuildall # restart all applications
dokku ps:rebuildall # rebuilds all applications
```
To upgrade herokuish from source, upgrade with: