Compare commits

...

4 Commits
4.2.3 ... 4.2.5

Author SHA1 Message Date
Romain Lespinasse
0141d9b38d fix: remove trailing hypen if any after cut 2022-06-16 19:55:01 +02:00
rlespinasse
33cd7a701d docs(README): improve the overwrite troubleshooting section 2022-04-16 19:25:44 +02:00
rlespinasse
2c5a627861 fix(GITHUB_REF_NAME): correctly fill the variable on pull request events 2022-04-16 19:25:44 +02:00
Romain Lespinasse
aa95092e35 docs: remove badges 2022-04-09 08:12:02 +02:00
3 changed files with 72 additions and 54 deletions

View File

@@ -11,14 +11,16 @@ jobs:
steps: steps:
- name: Checkout - name: Checkout
uses: actions/checkout@v3 uses: actions/checkout@v3
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Load using v4.x with prefix - name: Load using v4.x with prefix
uses: ./ uses: ./
with: with:
prefix: V4_ prefix: V4_
short-length: 8 short-length: 8
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Validate // Partial variables - name: Validate // Partial variables
run: | run: |
[[ "${{ env.GITHUB_REPOSITORY_OWNER_PART }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART }}" ]] [[ "${{ env.GITHUB_REPOSITORY_OWNER_PART }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART }}" ]]
@@ -96,14 +98,16 @@ jobs:
with: with:
path: this-action path: this-action
ref: ${{ github.ref }} ref: ${{ github.ref }}
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Load using v4.x with prefix - name: Load using v4.x with prefix
uses: ./this-action uses: ./this-action
with: with:
prefix: V4_ prefix: V4_
short-length: 8 short-length: 8
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Validate // Short SHA variables - name: Validate // Short SHA variables
run: | run: |
[[ "${{ env.GITHUB_SHA_SHORT }}" == "${{ env.V4_GITHUB_SHA_SHORT }}" ]] [[ "${{ env.GITHUB_SHA_SHORT }}" == "${{ env.V4_GITHUB_SHA_SHORT }}" ]]
@@ -120,6 +124,7 @@ jobs:
steps: steps:
- name: Checkout - name: Checkout
uses: actions/checkout@v3 uses: actions/checkout@v3
- name: Load using v4.x - name: Load using v4.x
uses: ./ uses: ./
@@ -200,14 +205,16 @@ jobs:
with: with:
path: this-action path: this-action
ref: ${{ github.ref }} ref: ${{ github.ref }}
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Load using v4.x with prefix - name: Load using v4.x with prefix
uses: ./this-action uses: ./this-action
with: with:
prefix: V4_ prefix: V4_
short-length: 8 short-length: 8
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Short SHA variables - name: Short SHA variables
run: | run: |
echo "sha : ${{ env.GITHUB_SHA_SHORT }}" echo "sha : ${{ env.GITHUB_SHA_SHORT }}"

View File

@@ -1,10 +1,6 @@
# GitHub Slug action # GitHub Slug action
[![Release][release-badge]][releases] This GitHub Action will expose the slug/short values of [some GitHub environment variables][default-environment-variables] inside your GitHub workflow.
![Lint][lint-badge]
[![Licence][license-badge]][license]
This GitHub Action will expose the slug/short values of [some GitHub environment variables][github-env-vars] inside your GitHub workflow.
## Table of Contents ## Table of Contents
@@ -22,6 +18,8 @@ This GitHub Action will expose the slug/short values of [some GitHub environment
- [Troubleshooting](#troubleshooting) - [Troubleshooting](#troubleshooting)
- [The SHORT variables doesn't have the same lengths as before](#the-short-variables-doesnt-have-the-same-lengths-as-before) - [The SHORT variables doesn't have the same lengths as before](#the-short-variables-doesnt-have-the-same-lengths-as-before)
- [One of the environment variables doesn't work as intended](#one-of-the-environment-variables-doesnt-work-as-intended) - [One of the environment variables doesn't work as intended](#one-of-the-environment-variables-doesnt-work-as-intended)
- [Known environment variable conflicts](#known-environment-variable-conflicts)
- [GITHUB_REF_NAME](#github_ref_name)
- [An action could not be found at the URI](#an-action-could-not-be-found-at-the-uri) - [An action could not be found at the URI](#an-action-could-not-be-found-at-the-uri)
- [Thanks for talking about us](#thanks-for-talking-about-us) - [Thanks for talking about us](#thanks-for-talking-about-us)
@@ -31,8 +29,9 @@ This GitHub Action will expose the slug/short values of [some GitHub environment
- put the variable content in lower case - put the variable content in lower case
- replace any character by `-` except `0-9`, `a-z`, `.`, and `_` - replace any character by `-` except `0-9`, `a-z`, `.`, and `_`
- remove leading and trailing `-` character - remove leading `-` characters
- limit the string size to 63 characters - limit the string size to 63 characters
- remove trailing `-` characters
<details> <details>
<summary>Others <b>Slug-ish</b> commands are available</summary> <summary>Others <b>Slug-ish</b> commands are available</summary>
@@ -47,11 +46,10 @@ This GitHub Action will expose the slug/short values of [some GitHub environment
- `<VAR>_CS` on others variables to keep the value case-sensitive - `<VAR>_CS` on others variables to keep the value case-sensitive
- Like `GITHUB_REF_SLUG_CS` - Like `GITHUB_REF_SLUG_CS`
Additional enhanced environment variables can be compute to help you around GitHub environment variables.
</p> </p>
</details> </details>
Additional enhanced environment variables can be compute to help you around GitHub environment variables.
## Use this action ## Use this action
Add this in your workflow Add this in your workflow
@@ -61,7 +59,9 @@ Add this in your workflow
uses: rlespinasse/github-slug-action@v4 uses: rlespinasse/github-slug-action@v4
``` ```
Others configurations <details>
<summary>Others configurations</summary>
<p>
- With a prefix - With a prefix
@@ -91,6 +91,8 @@ Others configurations
``` ```
**Warning**: If you leave it empty, you need to checkout the source first in order to let git decide the size by itself. **Warning**: If you leave it empty, you need to checkout the source first in order to let git decide the size by itself.
</p>
</details>
Check for more [examples][examples] (OS usage, URL use, ...) Check for more [examples][examples] (OS usage, URL use, ...)
@@ -182,34 +184,42 @@ To manage that moving length, you can use `short-length` input
### One of the environment variables doesn't work as intended ### One of the environment variables doesn't work as intended
[**Note**][naming-conventions]: GitHub reserves the `GITHUB_` environment variable prefix for internal use by GitHub. Setting an environment variable or secret with the `GITHUB_` prefix will result in an error. [**Note**][naming-conventions]: When you set a custom environment variable, you cannot use any of the default environment variable names. For a complete list of these, see [Default environment variables][default-environment-variables]. **If you attempt to override the value of one of these default environment variables, the assignment is ignored.**
Currently, a GitHub workflow setting a `GITHUB_` variable will not cause an error, it will just fail silently. If a variable start to be used as default environment variable, the environment variable may have a different behavior than the expected one.
And if a custom `GITHUB_` variable is in conflict with an official `GITHUB_` variable, the offical `GITHUB_` variable will override custom one.
<details> If this append, the `${{ env.GITHUB_AWESOME_VARIABLE }}` and `$GITHUB_AWESOME_VARIABLE` expression will not works in the same way.
<summary>Test workflow</summary>
<p> - `${{ env.GITHUB_AWESOME_VARIABLE }}` will serve the behavior of this action,
- `$GITHUB_AWESOME_VARIABLE` will serve the behavior of GitHub Action.
Otherwise the two expression will serve the behavior of this action.
This will not occurs if you use the `prefix` input to avoid the issue.
**NOTE:** If detected, the maintainers of this action will choose the best course of action depending of the impact.
#### Known environment variable conflicts
##### GITHUB_REF_NAME
The behavior is the same as the GitHub one except on `pull_request*` workflows ([Ready the full story][issue-104]).
- `${{ env.GITHUB_REF_NAME }}` will serve the behavior of this action,
- `$GITHUB_REF_NAME` will serve the behavior of GitHub Action.
On `pull_request*` workflows, the content will be `<PR-number>/merge` instead of the branch name.
A possible workaround is to use `prefix` input
```yaml ```yaml
name: Test - name: Inject slug/short variables
on: push uses: rlespinasse/github-slug-action@v4
jobs: with:
build: prefix: CI_
runs-on: ubuntu-latest
steps:
- run: echo ${GITHUB_REF}
# print "refs/heads/v4.x"
- run: echo "GITHUB_REF=one_value" >> "$GITHUB_ENV"
- run: echo ${GITHUB_REF}
# print "refs/heads/v4.x"
- run: echo "GITHUB_REF_SLUG=another_value" >> "$GITHUB_ENV"
- run: echo ${GITHUB_REF_SLUG}
# print "another_value"
``` ```
</p> Then `${{ env.CI_GITHUB_REF_NAME }}`, and `$CI_GITHUB_REF_NAME` will serve the behavior of this action.
</details> And `$GITHUB_REF_NAME` will serve the behavior of GitHub Action.
### An action could not be found at the URI ### An action could not be found at the URI
@@ -230,29 +240,30 @@ Please, use the current major tag `v4` or a version tag (see [releases pages][re
## Thanks for talking about us ## Thanks for talking about us
- [Mettre en place une CI/CD Angular avec GitHub Actions & Netlify][article-1] (in french :fr:) - [Mettre en place une CI/CD Angular avec GitHub Actions & Netlify][article-1] (in french :fr:)
- [Github Actions : enfin des pipelines accessibles aux développeurs][talk-1] (in french :fr:)
- [Action spotlight by Michael Heap][article-2] - [Action spotlight by Michael Heap][article-2]
- [Serverless Deploy Previews on GitHub Actions][article-3]
- [Let's Build a Continuous Delivery and Branching Process with Github Actions, Vercel and Heroku][article-4]
- [Github Actions : enfin des pipelines accessibles aux développeurs][talk-1] (in french :fr:)
- The next one is you. _Don't hesitate to add youself to this list._ - The next one is you. _Don't hesitate to add youself to this list._
[release-badge]: https://img.shields.io/github/workflow/status/rlespinasse/github-slug-action/Release?label=Build&logo=github&style=flat-square
[lint-badge]: https://img.shields.io/github/workflow/status/rlespinasse/github-slug-action/Lint?label=Lint&logo=github&style=flat-square
[license-badge]: https://img.shields.io/github/license/rlespinasse/github-slug-action?style=flat-square
[actions]: https://github.com/rlespinasse/github-slug-action/actions [actions]: https://github.com/rlespinasse/github-slug-action/actions
[license]: https://github.com/rlespinasse/github-slug-action/blob/v4.x/LICENSE [license]: https://github.com/rlespinasse/github-slug-action/blob/v4.x/LICENSE
[examples]: https://github.com/rlespinasse/github-slug-action/tree/v4.x/examples [examples]: https://github.com/rlespinasse/github-slug-action/tree/v4.x/examples
[custom-variable]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=enhancement&template=feature_request.md&title= [custom-variable]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
[releases]: https://github.com/rlespinasse/github-slug-action/releases [releases]: https://github.com/rlespinasse/github-slug-action/releases
[issue-15]: https://github.com/rlespinasse/github-slug-action/issues/15 [issue-15]: https://github.com/rlespinasse/github-slug-action/issues/15
[issue-104]: https://github.com/rlespinasse/github-slug-action/issues/104
[git-revpars]: https://git-scm.com/docs/git-rev-parse#Documentation/git-rev-parse.txt---shortlength [git-revpars]: https://git-scm.com/docs/git-rev-parse#Documentation/git-rev-parse.txt---shortlength
[git-core-abbrev]: https://git-scm.com/docs/git-config#Documentation/git-config.txt-coreabbrev [git-core-abbrev]: https://git-scm.com/docs/git-config#Documentation/git-config.txt-coreabbrev
[github-env-vars]: https://docs.github.com/en/free-pro-team@latest/actions/reference/environment-variables#default-environment-variables [default-environment-variables]: https://docs.github.com/en/actions/learn-github-actions/environment-variables#default-environment-variables
[dependabot]: https://docs.github.com/en/free-pro-team@latest/github/administering-a-repository/keeping-your-actions-up-to-date-with-github-dependabot [dependabot]: https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot
[webhooks-and-events]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads [webhooks-and-events]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads
[naming-conventions]: https://docs.github.com/en/actions/reference/environment-variables#naming-conventions-for-environment-variables [naming-conventions]: https://docs.github.com/en/actions/reference/environment-variables#naming-conventions-for-environment-variables
[article-1]: https://esensconsulting.medium.com/mettre-en-place-une-ci-cd-angular-avec-github-actions-netlify-ca0b59b99ed8 [article-1]: https://esensconsulting.medium.com/mettre-en-place-une-ci-cd-angular-avec-github-actions-netlify-ca0b59b99ed8
[article-2]: https://michaelheap.com/github-slug-action/ [article-2]: https://michaelheap.com/github-slug-action/
[talk-1]: https://www.youtube.com/watch?v=RHnTJBwcE98 [article-3]: https://barstool.engineering/serverless-deploy-previews-on-github-actions/
[article-4]: https://javascript.plainenglish.io/lets-build-a-continuous-delivery-and-branching-process-c27dae09f0b6
[talk-1]: https://www.youtube.com/watch?v=F5mBDmOQcvE

View File

@@ -26,30 +26,30 @@ runs:
INPUT_SLUG_MAXLENGTH: ${{ inputs.slug-maxlength }} INPUT_SLUG_MAXLENGTH: ${{ inputs.slug-maxlength }}
INPUT_SHORT_LENGTH: ${{ inputs.short-length }} INPUT_SHORT_LENGTH: ${{ inputs.short-length }}
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_REPOSITORY key: GITHUB_REPOSITORY
value: ${{ github.repository }} value: ${{ github.repository }}
prefix: ${{ inputs.prefix }} prefix: ${{ inputs.prefix }}
slug-maxlength: ${{ inputs.slug-maxlength }} slug-maxlength: ${{ inputs.slug-maxlength }}
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_REF key: GITHUB_REF
prefix: ${{ inputs.prefix }} prefix: ${{ inputs.prefix }}
slug-maxlength: ${{ inputs.slug-maxlength }} slug-maxlength: ${{ inputs.slug-maxlength }}
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_HEAD_REF key: GITHUB_HEAD_REF
prefix: ${{ inputs.prefix }} prefix: ${{ inputs.prefix }}
slug-maxlength: ${{ inputs.slug-maxlength }} slug-maxlength: ${{ inputs.slug-maxlength }}
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_BASE_REF key: GITHUB_BASE_REF
prefix: ${{ inputs.prefix }} prefix: ${{ inputs.prefix }}
slug-maxlength: ${{ inputs.slug-maxlength }} slug-maxlength: ${{ inputs.slug-maxlength }}
# Specific values # Specific values
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_EVENT_REF key: GITHUB_EVENT_REF
value: ${{ github.event.ref }} value: ${{ github.event.ref }}
@@ -58,9 +58,9 @@ runs:
# Calculated values # Calculated values
- id: get-github-ref-name - id: get-github-ref-name
run: echo "::set-output name=github-ref-name::$(echo "${{ github.head_ref || github.ref }}" | cut -d/ -f3)" run: echo "::set-output name=github-ref-name::${{ github.head_ref || github.ref_name }}"
shell: bash shell: bash
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_REF_NAME key: GITHUB_REF_NAME
value: ${{ steps.get-github-ref-name.outputs.github-ref-name }} value: ${{ steps.get-github-ref-name.outputs.github-ref-name }}
@@ -69,7 +69,7 @@ runs:
- id: get-github-repository-owner-part - id: get-github-repository-owner-part
run: echo "::set-output name=github-repository-owner-part::$(echo $GITHUB_REPOSITORY | cut -d/ -f1)" run: echo "::set-output name=github-repository-owner-part::$(echo $GITHUB_REPOSITORY | cut -d/ -f1)"
shell: bash shell: bash
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_REPOSITORY_OWNER_PART key: GITHUB_REPOSITORY_OWNER_PART
value: ${{ steps.get-github-repository-owner-part.outputs.github-repository-owner-part }} value: ${{ steps.get-github-repository-owner-part.outputs.github-repository-owner-part }}
@@ -78,7 +78,7 @@ runs:
- id: get-github-repository-name-part - id: get-github-repository-name-part
run: echo "::set-output name=github-repository-name-part::$(echo $GITHUB_REPOSITORY | cut -d/ -f2)" run: echo "::set-output name=github-repository-name-part::$(echo $GITHUB_REPOSITORY | cut -d/ -f2)"
shell: bash shell: bash
- uses: rlespinasse/slugify-value@v1.2.3 - uses: rlespinasse/slugify-value@v1.3.2
with: with:
key: GITHUB_REPOSITORY_NAME_PART key: GITHUB_REPOSITORY_NAME_PART
value: ${{ steps.get-github-repository-name-part.outputs.github-repository-name-part }} value: ${{ steps.get-github-repository-name-part.outputs.github-repository-name-part }}