This repository has been archived on 2021-07-22. You can view files and clone it, but cannot push or open issues or pull requests.
stack-ssh-deploy/README.md

43 lines
1.3 KiB
Markdown
Raw Normal View History

2020-09-23 06:32:50 +00:00
# stack-ssh-deploy
[![Build Status](https://drone.autonomic.zone/api/badges/autonomic-cooperative/stack-ssh-deploy/status.svg)](https://drone.autonomic.zone/autonomic-cooperative/stack-ssh-deploy)
Deploy swarm stacks against a SSH based remote docker daemon context.
2020-09-23 06:56:27 +00:00
This is meant to be used as a [Drone plugin](http://plugins.drone.io/).
2020-09-23 06:44:37 +00:00
## Settings
### With defaults
2020-09-23 06:50:38 +00:00
- **compose** (default: `compose.yml`): compose file to use for deploying
- **host** (default: `swarm.autonomic.zone`): Host to deploy to (don't include `ssh://`)
- **port** (default: `222`): SSH port to connect to
- **user** (default: `drone`): System user to connect via SSH with
### Without defaults
2020-09-23 06:44:37 +00:00
- **deploy_key**: SSH private key part for ssh public key authentication
- **stack**: Name of the stack to be deployed
2020-09-23 06:44:37 +00:00
2020-09-23 06:32:50 +00:00
## Example
```yaml
---
kind: pipeline
name: deploy to swarm
steps:
- name: stack deploy
2020-09-25 10:57:09 +00:00
image: decentral1se/stack-ssh-deploy:latest
2020-09-23 06:32:50 +00:00
settings:
2020-09-23 06:50:38 +00:00
stack: mystack
2020-09-23 06:32:50 +00:00
deploy_key:
from_secret: drone_deploy_key
```
2020-09-23 06:44:56 +00:00
## Publishing
2020-09-23 06:56:27 +00:00
The version can be bumped in the [.drone.yml](./.drone.yml) file. Please use [semver](https://semver.org).
2020-09-23 06:44:56 +00:00
If you push a commit to master, the [Drone config](./.drone.yml) will publish to [Docker Hub](https://hub.docker.com/r/decentral1se/stack-ssh-deploy).