Skip to content

Commit 93ac958

Browse files
committed
Update README.md
1 parent 69eb6df commit 93ac958

File tree

3 files changed

+35
-30
lines changed

3 files changed

+35
-30
lines changed

CONTRIBUTING.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@
55
66
Note: This guide is not updated for Compose but those tests work similar.
77

8+
To contribute to the [documentation site](https://docker-deploy.cssnr.com/) go to [cssnr/stack-deploy-docs](https://github.com/cssnr/stack-deploy-docs).
9+
810
## Workflow
911

1012
1. Fork the repository.

README.md

Lines changed: 32 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
[![GitHub Tag Major](https://img.shields.io/github/v/tag/cssnr/stack-deploy-action?sort=semver&filter=!v*.*&logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/stack-deploy-action/tags)
2-
[![GitHub Tag Minor](https://img.shields.io/github/v/tag/cssnr/stack-deploy-action?sort=semver&filter=!v*.*.*&logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/stack-deploy-action/tags)
2+
[![GitHub Tag Minor](https://img.shields.io/github/v/tag/cssnr/stack-deploy-action?sort=semver&filter=!v*.*.*&logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/stack-deploy-action/releases)
33
[![GitHub Release Version](https://img.shields.io/github/v/release/cssnr/stack-deploy-action?logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/stack-deploy-action/releases/latest)
4-
[![Workflow Release](https://img.shields.io/github/actions/workflow/status/cssnr/stack-deploy-action/release.yaml?logo=github&label=release)](https://github.com/cssnr/stack-deploy-action/actions/workflows/release.yaml)
5-
[![Workflow Test](https://img.shields.io/github/actions/workflow/status/cssnr/stack-deploy-action/test.yaml?logo=github&label=test)](https://github.com/cssnr/stack-deploy-action/actions/workflows/test.yaml)
6-
[![Workflow Lint](https://img.shields.io/github/actions/workflow/status/cssnr/stack-deploy-action/lint.yaml?logo=github&label=lint)](https://github.com/cssnr/stack-deploy-action/actions/workflows/lint.yaml)
4+
[![Workflow Release](https://img.shields.io/github/actions/workflow/status/cssnr/stack-deploy-action/release.yaml?logo=cachet&label=release)](https://github.com/cssnr/stack-deploy-action/actions/workflows/release.yaml)
5+
[![Workflow Test](https://img.shields.io/github/actions/workflow/status/cssnr/stack-deploy-action/test.yaml?logo=cachet&label=test)](https://github.com/cssnr/stack-deploy-action/actions/workflows/test.yaml)
6+
[![Workflow Lint](https://img.shields.io/github/actions/workflow/status/cssnr/stack-deploy-action/lint.yaml?logo=cachet&label=lint)](https://github.com/cssnr/stack-deploy-action/actions/workflows/lint.yaml)
77
[![GitHub Last Commit](https://img.shields.io/github/last-commit/cssnr/stack-deploy-action?logo=github&label=updated)](https://github.com/cssnr/stack-deploy-action/pulse)
88
[![Codeberg Last Commit](https://img.shields.io/gitea/last-commit/cssnr/stack-deploy-action/master?gitea_url=https%3A%2F%2Fcodeberg.org%2F&logo=codeberg&logoColor=white&label=updated)](https://codeberg.org/cssnr/stack-deploy-action)
9+
[![Docs Last Commit](https://img.shields.io/github/last-commit/cssnr/stack-deploy-docs?logo=vitepress&logoColor=white&label=docs)](https://docker-deploy.cssnr.com/)
910
[![GitHub Contributors](https://img.shields.io/github/contributors/cssnr/stack-deploy-action?logo=github)](https://github.com/cssnr/stack-deploy-action/graphs/contributors)
1011
[![GitHub Repo Size](https://img.shields.io/github/repo-size/cssnr/stack-deploy-action?logo=bookstack&logoColor=white&label=size)](https://github.com/cssnr/stack-deploy-action)
1112
[![GitHub Top Language](https://img.shields.io/github/languages/top/cssnr/stack-deploy-action?logo=sharp&logoColor=white)](https://github.com/cssnr/stack-deploy-action)
@@ -18,10 +19,10 @@
1819

1920
# Docker Stack Deploy Action
2021

22+
- [Features](#Features)
2123
- [Inputs](#Inputs)
2224
- [Examples](#Examples)
2325
- [Tags](#Tags)
24-
- [Features](#Features)
2526
- [Support](#Support)
2627
- [Contributing](#Contributing)
2728

@@ -33,8 +34,8 @@ Easily Deploy a Docker Swarm or Compose Stack, from a compose file, to a remote
3334
Deploy directly from the actions working directory without copying any files using a remote Docker context.
3435
This allows you to easily prepare your environment for deployment using normal steps.
3536

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.
37+
Supports many [features](#features) including authenticating against a private registry, deploying multiple stack files,
38+
setting custom arguments, and much more.
3839

3940
```yaml
4041
- name: 'Stack Deploy'
@@ -50,13 +51,27 @@ You can view all the [features](https://docker-deploy.cssnr.com/guides/features)
5051
mode: swarm # if not using swarm set to: compose
5152
```
5253
53-
For usage and setup guides, visit the website: https://docker-deploy.cssnr.com/
54+
**Make sure to review the [Inputs](#inputs), available [Tags](#tags) and additional [Examples](#examples).**
5455
5556
_Portainer Users: You can deploy directly to Portainer with: [cssnr/portainer-stack-deploy-action](https://github.com/cssnr/portainer-stack-deploy-action)_
5657
58+
## Features
59+
60+
- Deploy to Docker Swarm or Compose.
61+
- Deploy over SSH using keyfile or password.
62+
- Deploy from the current working directory.
63+
- Deploy from a private registry with credentials.
64+
- Job Summary with deployment output, including errors.
65+
- Supports multiple compose file and stack deployments.
66+
- Allows setting custom arguments for the deployment command.
67+
- View more the [Features](https://docker-deploy.cssnr.com/guides/features) on the website.
68+
69+
Don't see your feature here? Please help by submitting a [Feature Request](https://github.com/cssnr/stack-deploy-action/discussions/categories/feature-requests).
70+
5771
## Inputs
5872
59-
View the full [Inputs Documentation](https://docker-deploy.cssnr.com/docs/inputs) on the website.
73+
> [!IMPORTANT]
74+
> View the [Inputs Documentation](https://docker-deploy.cssnr.com/docs/inputs) for comprehensive, up-to-date documentation.
6075
6176
| Input Name | Required | Default Value | Short Description of Input |
6277
| :------------------- | :----------: | :---------------------------------- | :---------------------------------------- |
@@ -74,7 +89,7 @@ View the full [Inputs Documentation](https://docker-deploy.cssnr.com/docs/inputs
7489
| `detach`**²** | - | `true` | Detach Flag, `false`, to disable \* |
7590
| `prune`**²** | - | `false` | Prune Flag, `true`, to enable |
7691
| `resolve_image`**²** | - | `always` | Resolve [`always`, `changed`, `never`] \* |
77-
| `registry_auth`**²** | - | - | Enable Registry Authentication \* |
92+
| `registry_auth`**²** | - | `false` | Enable Registry Authentication \* |
7893
| `registry_host` | - | - | Registry Authentication Host \* |
7994
| `registry_user` | - | - | Registry Authentication Username \* |
8095
| `registry_pass` | - | - | Registry Authentication Password \* |
@@ -212,7 +227,7 @@ failed to create network test_stack-deploy_default: Error response from daemon:
212227

213228
## Examples
214229

215-
View more [Examples](https://docker-deploy.cssnr.com/guides/examples) on the website.
230+
Additional [Examples](https://docker-deploy.cssnr.com/guides/examples) are available on the website.
216231

217232
💡 _Click on an example heading to expand or collapse the example._
218233

@@ -371,7 +386,7 @@ jobs:
371386
372387
steps:
373388
- name: 'Checkout'
374-
uses: actions/checkout@v4
389+
uses: actions/checkout@v5
375390
376391
- name: 'Stack Deploy'
377392
uses: cssnr/stack-deploy-action@v1
@@ -415,10 +430,10 @@ jobs:
415430
416431
steps:
417432
- name: 'Checkout'
418-
uses: actions/checkout@v4
433+
uses: actions/checkout@v5
419434
420435
- name: 'Setup Buildx'
421-
uses: docker/setup-buildx-action@v2
436+
uses: docker/setup-buildx-action@v3
422437
with:
423438
platforms: 'linux/amd64,linux/arm64'
424439
@@ -502,20 +517,6 @@ You can view the release notes for each version on the [releases](https://github
502517
The **Major** tag is recommended. It is the most up-to-date and always backwards compatible.
503518
Breaking changes would result in a **Major** version bump. At a minimum you should use a **Minor** tag.
504519

505-
## Features
506-
507-
View all the [Features](https://docker-deploy.cssnr.com/docs/inputs) on the website.
508-
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).
518-
519520
# Support
520521

521522
For general help or to request a feature see:
@@ -533,9 +534,9 @@ For more information, see the CSSNR [SUPPORT.md](https://github.com/cssnr/.githu
533534

534535
# Contributing
535536

536-
If you would like to submit a PR, please review the [CONTRIBUTING.md](CONTRIBUTING.md).
537+
If you would like to submit a PR, please review the [CONTRIBUTING.md](#contributing-ov-file).
537538

538-
To contribute to the [documentation site](https://docker-deploy.cssnr.com/) go here: https://github.com/cssnr/stack-deploy-docs
539+
To contribute to the [documentation site](https://docker-deploy.cssnr.com/) go to [cssnr/stack-deploy-docs](https://github.com/cssnr/stack-deploy-docs).
539540

540541
Please consider making a donation to support the development of this project
541542
and [additional](https://cssnr.com/) open source projects.
@@ -556,5 +557,6 @@ Additionally, you can support other GitHub Actions I have published:
556557
- [Docker Tags Action](https://github.com/cssnr/docker-tags-action?tab=readme-ov-file#readme)
557558
- [Package Changelog Action](https://github.com/cssnr/package-changelog-action?tab=readme-ov-file#readme)
558559
- [NPM Outdated Check Action](https://github.com/cssnr/npm-outdated-action?tab=readme-ov-file#readme)
560+
- [Algolia Crawler Action](https://github.com/cssnr/algolia-crawler-action?tab=readme-ov-file#readme)
559561

560562
For a full list of current projects visit: [https://cssnr.github.io/](https://cssnr.github.io/)

action.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ inputs:
5858
registry_auth:
5959
description: "Enable Registry Auth"
6060
required: false
61+
default: "false"
6162
registry_host:
6263
description: "Registry Auth Hostname"
6364
required: false

0 commit comments

Comments
 (0)