mirror of
https://gitlab.com/psuapp/psu.git
synced 2024-08-30 18:12:34 +00:00
Add endpoint's Docker API proxy section to Readme
This commit is contained in:
parent
0014a39265
commit
dca719a15e
21
README.md
21
README.md
@ -19,6 +19,7 @@
|
|||||||
- [YAML configuration file](#yaml-configuration-file)
|
- [YAML configuration file](#yaml-configuration-file)
|
||||||
- [JSON configuration file](#json-configuration-file)
|
- [JSON configuration file](#json-configuration-file)
|
||||||
- [Environment variables for deployed stacks](#environment-variables-for-deployed-stacks)
|
- [Environment variables for deployed stacks](#environment-variables-for-deployed-stacks)
|
||||||
|
- [Endpoint's Docker API proxy](#endpoints-docker-api-proxy)
|
||||||
- [Log level](#log-level)
|
- [Log level](#log-level)
|
||||||
- [Exit statuses](#exit-statuses)
|
- [Exit statuses](#exit-statuses)
|
||||||
- [Contributing](#contributing)
|
- [Contributing](#contributing)
|
||||||
@ -160,6 +161,26 @@ echo "stack.deploy.env-file: .env" > .config.yml
|
|||||||
psu stack deploy django-stack -c /path/to/docker-compose.yml --config .config.yml
|
psu stack deploy django-stack -c /path/to/docker-compose.yml --config .config.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Endpoint's Docker API proxy
|
||||||
|
|
||||||
|
If you want finer-grained control over an endpoint's Docker daemon you can expose it through a proxy and configure a local Docker client to use it.
|
||||||
|
|
||||||
|
First, expose the endpoint's Docker API:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
psu proxy --endpoint primary --address 127.0.0.1:2375
|
||||||
|
```
|
||||||
|
|
||||||
|
Then (in a different shell), configure a local Docker client to use the exposed API:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export DOCKER_HOST=tcp://127.0.0.1:2375
|
||||||
|
```
|
||||||
|
|
||||||
|
Now you can run `docker ...` commands in the `primary` endpoint as in a local Docker installation, **with the added benefit of using Portainer's RBAC**.
|
||||||
|
|
||||||
|
*Note that creating stacks through `docker stack ...` instead of `psu stack ...` will give you *limited* control over them, as they are created outside of Portainer.*
|
||||||
|
|
||||||
### Log level
|
### Log level
|
||||||
|
|
||||||
You can control how much noise you want the program to do by setting the log level. There are seven log levels:
|
You can control how much noise you want the program to do by setting the log level. There are seven log levels:
|
||||||
|
Loading…
Reference in New Issue
Block a user