Skip to content

Commit 69eb6df

Browse files
authored
Update README.md (#38)
1 parent d58b92b commit 69eb6df

File tree

1 file changed

+45
-21
lines changed

1 file changed

+45
-21
lines changed

README.md

Lines changed: 45 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -26,24 +26,38 @@
2626
- [Contributing](#Contributing)
2727

2828
> [!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.
3130
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.
3432

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.
3635

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.
3838

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/
4254
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)_
4456
4557
## Inputs
4658
59+
View the full [Inputs Documentation](https://docker-deploy.cssnr.com/docs/inputs) on the website.
60+
4761
| Input Name | Required | Default Value | Short Description of Input |
4862
| :------------------- | :----------: | :---------------------------------- | :---------------------------------------- |
4963
| `name` | **Yes** | - | Docker Stack/Project Name \* |
@@ -84,6 +98,8 @@ fi
8498

8599
Compose Note: `"${STACK_FILES[@]}"` is an array of `-f docker-compose.yaml` for every `file` in the argument.
86100

101+
---
102+
87103
</details>
88104

89105
**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:
184200
- name: 'Stack Deploy'
185201
uses: cssnr/stack-deploy-action@v1
186202
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
189205
host: ${{ secrets.DOCKER_HOST }}
190-
port: ${{ secrets.DOCKER_PORT }}
191206
user: ${{ secrets.DOCKER_USER }}
207+
port: 22 # 22 is default, you can remove or change this
192208
pass: ${{ secrets.DOCKER_PASS }} # not needed with ssh_key
193209
ssh_key: ${{ secrets.DOCKER_SSH_KEY }} # not needed with pass
210+
mode: swarm # if not using swarm set to: compose
194211
```
195212

196213
## Examples
197214

215+
View more [Examples](https://docker-deploy.cssnr.com/guides/examples) on the website.
216+
198217
💡 _Click on an example heading to expand or collapse the example._
199218

200219
<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
485504

486505
## Features
487506

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.
494508

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).
496518

497519
# Support
498520

@@ -505,14 +527,16 @@ If you are experiencing an issue/bug or getting unexpected results you can:
505527

506528
- Report an Issue: https://github.com/cssnr/stack-deploy-action/issues
507529
- 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)
509531

510532
For more information, see the CSSNR [SUPPORT.md](https://github.com/cssnr/.github/blob/master/.github/SUPPORT.md#support).
511533

512534
# Contributing
513535

514536
If you would like to submit a PR, please review the [CONTRIBUTING.md](CONTRIBUTING.md).
515537

538+
To contribute to the [documentation site](https://docker-deploy.cssnr.com/) go here: https://github.com/cssnr/stack-deploy-docs
539+
516540
Please consider making a donation to support the development of this project
517541
and [additional](https://cssnr.com/) open source projects.
518542

0 commit comments

Comments
 (0)