You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+45-21Lines changed: 45 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,24 +26,38 @@
26
26
-[Contributing](#Contributing)
27
27
28
28
> [!TIP]
29
-
> Now works with Docker **Compose. No Swarm Required!**
30
-
> ▶️ Set `mode: compose`. See [Inputs](#Inputs) for more details...
29
+
> ▶️ View the [Getting Started Guide](https://docker-deploy.cssnr.com/guides/get-started) on the website.
31
30
32
-
This action deploys a docker stack from a compose file to a remote docker host using SSH Password or Key File Authentication.
33
-
You can also optionally authenticate against a private registry using a username and password.
31
+
Easily Deploy a Docker Swarm or Compose Stack, from a compose file, to a remote Docker host over SSH, with keyfile or password authentication.
34
32
35
-
This action uses a remote docker context to deploy the stack from the working directory allowing you to easily prepare the workspace for deployment.
33
+
Deploy directly from the actions working directory without copying any files using a remote Docker context.
34
+
This allows you to easily prepare your environment for deployment using normal steps.
36
35
37
-
**Portainer Users:** You can deploy directly to Portainer with: [cssnr/portainer-stack-deploy-action](https://github.com/cssnr/portainer-stack-deploy-action)
36
+
Supports authenticating against a private registry, deploying multiple stack files, setting custom arguments, and much more.
37
+
You can view all the [features](https://docker-deploy.cssnr.com/guides/features) on the website.
38
38
39
-
> [!NOTE]
40
-
> Please submit a [Feature Request](https://github.com/cssnr/stack-deploy-action/discussions/categories/feature-requests)
41
-
> for new features or [Open an Issue](https://github.com/cssnr/stack-deploy-action/issues) if you find any bugs.
39
+
```yaml
40
+
- name: 'Stack Deploy'
41
+
uses: cssnr/stack-deploy-action@v1
42
+
with:
43
+
name: 'stack-name'# set to your stack name
44
+
file: 'docker-compose.yaml'# set to your compose file
45
+
host: ${{ secrets.DOCKER_HOST }}
46
+
user: ${{ secrets.DOCKER_USER }}
47
+
port: 22# 22 is default, you can remove or change this
48
+
pass: ${{ secrets.DOCKER_PASS }} # not needed with ssh_key
49
+
ssh_key: ${{ secrets.DOCKER_SSH_KEY }} # not needed with pass
50
+
mode: swarm # if not using swarm set to: compose
51
+
```
52
+
53
+
For usage and setup guides, visit the website: https://docker-deploy.cssnr.com/
42
54
43
-
For more details see [action.yaml](action.yaml) and [src/main.sh](src/main.sh).
55
+
_Portainer Users: You can deploy directly to Portainer with: [cssnr/portainer-stack-deploy-action](https://github.com/cssnr/portainer-stack-deploy-action)_
44
56
45
57
## Inputs
46
58
59
+
View the full [Inputs Documentation](https://docker-deploy.cssnr.com/docs/inputs) on the website.
Compose Note: `"${STACK_FILES[@]}"`is an array of `-f docker-compose.yaml` for every `file` in the argument.
86
100
101
+
---
102
+
87
103
</details>
88
104
89
105
**name:** Stack name for Swarm and project name for Compose.
@@ -184,17 +200,20 @@ failed to create network test_stack-deploy_default: Error response from daemon:
184
200
- name: 'Stack Deploy'
185
201
uses: cssnr/stack-deploy-action@v1
186
202
with:
187
-
name: 'stack-name'
188
-
file: 'docker-compose-swarm.yaml'
203
+
name: 'stack-name' # set to your stack name
204
+
file: 'docker-compose.yaml' # set to your compose file
189
205
host: ${{ secrets.DOCKER_HOST }}
190
-
port: ${{ secrets.DOCKER_PORT }}
191
206
user: ${{ secrets.DOCKER_USER }}
207
+
port: 22 # 22 is default, you can remove or change this
192
208
pass: ${{ secrets.DOCKER_PASS }} # not needed with ssh_key
193
209
ssh_key: ${{ secrets.DOCKER_SSH_KEY }} # not needed with pass
210
+
mode: swarm # if not using swarm set to: compose
194
211
```
195
212
196
213
## Examples
197
214
215
+
View more [Examples](https://docker-deploy.cssnr.com/guides/examples) on the website.
216
+
198
217
💡 _Click on an example heading to expand or collapse the example._
199
218
200
219
<details open><summary>With Password, docker login and --with-registry-auth</summary>
@@ -485,14 +504,17 @@ Breaking changes would result in a **Major** version bump. At a minimum you shou
485
504
486
505
## Features
487
506
488
-
- Deploy to a remote host using SSH or Password authentication.
489
-
- Deploy using a remote context from the current working directory.
490
-
- Deploy from a compose file to either a Docker Swarm or Compose host.
491
-
- Displays output in logs, captures it in the Summary, and checks the status.
492
-
- Allows logging into a private registry and deploying with registry auth.
493
-
- Allows specifying all arguments for both Swarm and Compose deployments.
507
+
View all the [Features](https://docker-deploy.cssnr.com/docs/inputs) on the website.
494
508
495
-
Don't see your feature here? Request it below in the [Support](#Support) section.
509
+
- Deploy to Docker Swarm or Compose.
510
+
- Deploy over SSH using keyfile or password.
511
+
- Deploy from the current working directory.
512
+
- Deploy from a private registry with credentials.
513
+
- Job Summary with deployment output, including errors.
514
+
- Supports multiple compose file and stack deployments.
515
+
- Allows setting custom arguments for the deployment command.
516
+
517
+
Don't see your feature here? Please help by submitting a [Feature Request](https://github.com/cssnr/stack-deploy-action/discussions/categories/feature-requests).
496
518
497
519
# Support
498
520
@@ -505,14 +527,16 @@ If you are experiencing an issue/bug or getting unexpected results you can:
505
527
506
528
- Report an Issue: https://github.com/cssnr/stack-deploy-action/issues
507
529
- Chat with us on Discord: https://discord.gg/wXy6m2X8wY
508
-
- Provide General Feedback: [https://cssnr.github.io/feedback/](https://cssnr.github.io/feedback/?app=Stack%20Deploy)
530
+
- Provide General Feedback: [https://cssnr.github.io/feedback/](https://cssnr.github.io/feedback/?app=Stack%20Deploy%20Action)
509
531
510
532
For more information, see the CSSNR [SUPPORT.md](https://github.com/cssnr/.github/blob/master/.github/SUPPORT.md#support).
511
533
512
534
# Contributing
513
535
514
536
If you would like to submit a PR, please review the [CONTRIBUTING.md](CONTRIBUTING.md).
515
537
538
+
To contribute to the [documentation site](https://docker-deploy.cssnr.com/) go here: https://github.com/cssnr/stack-deploy-docs
539
+
516
540
Please consider making a donation to support the development of this project
517
541
and [additional](https://cssnr.com/) open source projects.
0 commit comments