mirror of
https://github.com/actions/deploy-pages.git
synced 2026-03-28 17:04:53 +00:00
Compare commits
4 Commits
v4.0.2
...
report-api
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
4c4a9146cc | ||
|
|
88e44eb7c2 | ||
|
|
5c24c29b4d | ||
|
|
0f34457470 |
@@ -13,5 +13,5 @@
|
|||||||
"rules": {
|
"rules": {
|
||||||
"semi": ["error", "never"]
|
"semi": ["error", "never"]
|
||||||
},
|
},
|
||||||
"ignorePatterns": ["/dist/"]
|
"ignorePatterns": ["/dist/", "/pre/"]
|
||||||
}
|
}
|
||||||
|
|||||||
1
.gitattributes
vendored
1
.gitattributes
vendored
@@ -1 +0,0 @@
|
|||||||
dist/** -diff linguist-generated=true
|
|
||||||
11
.github/dependabot.yml
vendored
11
.github/dependabot.yml
vendored
@@ -1,11 +0,0 @@
|
|||||||
version: 2
|
|
||||||
updates:
|
|
||||||
- package-ecosystem: 'github-actions'
|
|
||||||
directory: '/'
|
|
||||||
schedule:
|
|
||||||
interval: 'weekly'
|
|
||||||
|
|
||||||
- package-ecosystem: 'npm'
|
|
||||||
directory: '/'
|
|
||||||
schedule:
|
|
||||||
interval: 'weekly'
|
|
||||||
4
.github/release-drafter.yml
vendored
4
.github/release-drafter.yml
vendored
@@ -6,11 +6,7 @@ template: |
|
|||||||
|
|
||||||
$CHANGES
|
$CHANGES
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
See details of [all code changes](https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION) since previous release.
|
See details of [all code changes](https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION) since previous release.
|
||||||
|
|
||||||
:warning: For use with products other than GitHub.com, such as GitHub Enterprise Server, please consult the [compatibility table](https://github.com/$OWNER/$REPOSITORY/#compatibilty).
|
|
||||||
categories:
|
categories:
|
||||||
- title: '🚀 Features'
|
- title: '🚀 Features'
|
||||||
labels:
|
labels:
|
||||||
|
|||||||
24
.github/workflows/check-dist.yml
vendored
24
.github/workflows/check-dist.yml
vendored
@@ -3,7 +3,7 @@
|
|||||||
# `index.js` is the code that will run.
|
# `index.js` is the code that will run.
|
||||||
# For our project, we generate this file using `ncc`
|
# For our project, we generate this file using `ncc`
|
||||||
# We need to make sure the checked-in `index.js` actually matches what we expect it to be.
|
# We need to make sure the checked-in `index.js` actually matches what we expect it to be.
|
||||||
name: Check distributables
|
name: Check dist/
|
||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
@@ -21,14 +21,12 @@ jobs:
|
|||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- name: Checkout
|
- uses: actions/checkout@v2
|
||||||
uses: actions/checkout@v4
|
|
||||||
|
|
||||||
- name: Setup Node.JS
|
- name: Set Node.js 16.x
|
||||||
uses: actions/setup-node@v4
|
uses: actions/setup-node@v1
|
||||||
with:
|
with:
|
||||||
node-version-file: '.node-version'
|
node-version: 16.x
|
||||||
cache: npm
|
|
||||||
|
|
||||||
- name: Install dependencies
|
- name: Install dependencies
|
||||||
run: npm ci
|
run: npm ci
|
||||||
@@ -37,7 +35,6 @@ jobs:
|
|||||||
run: npm run prepare
|
run: npm run prepare
|
||||||
|
|
||||||
- name: Compare the expected and actual dist/ directories
|
- name: Compare the expected and actual dist/ directories
|
||||||
id: diff
|
|
||||||
run: |
|
run: |
|
||||||
if [ "$(git diff --ignore-space-at-eol dist/ | wc -l)" -gt "0" ]; then
|
if [ "$(git diff --ignore-space-at-eol dist/ | wc -l)" -gt "0" ]; then
|
||||||
echo "Detected uncommitted changes after build in dist folder. See status below:"
|
echo "Detected uncommitted changes after build in dist folder. See status below:"
|
||||||
@@ -45,9 +42,8 @@ jobs:
|
|||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# If index.js was different than expected, upload the expected version as an artifact
|
if [ "$(git diff --ignore-space-at-eol pre/ | wc -l)" -gt "0" ]; then
|
||||||
- uses: actions/upload-artifact@v4
|
echo "Detected uncommitted changes after build in pre folder. See status below:"
|
||||||
if: ${{ failure() && steps.diff.conclusion == 'failure' }}
|
git diff
|
||||||
with:
|
exit 1
|
||||||
name: dist
|
fi
|
||||||
path: dist/
|
|
||||||
|
|||||||
12
.github/workflows/check-formatting.yml
vendored
12
.github/workflows/check-formatting.yml
vendored
@@ -1,4 +1,4 @@
|
|||||||
name: Check formatting
|
name: Checking formatting
|
||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
@@ -15,17 +15,17 @@ concurrency:
|
|||||||
cancel-in-progress: true
|
cancel-in-progress: true
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
format:
|
test:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- name: Checkout
|
- name: Checkout
|
||||||
uses: actions/checkout@v4
|
uses: actions/checkout@v3
|
||||||
|
|
||||||
- name: Setup Node.JS
|
- name: Setup Node.JS
|
||||||
uses: actions/setup-node@v4
|
uses: actions/setup-node@v3
|
||||||
with:
|
with:
|
||||||
node-version-file: '.node-version'
|
node-version: 16.x
|
||||||
cache: npm
|
cache: 'npm'
|
||||||
|
|
||||||
- name: Install dependencies
|
- name: Install dependencies
|
||||||
run: npm ci
|
run: npm ci
|
||||||
|
|||||||
12
.github/workflows/check-linter.yml
vendored
12
.github/workflows/check-linter.yml
vendored
@@ -1,4 +1,4 @@
|
|||||||
name: Check linting
|
name: Check linter
|
||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
@@ -15,17 +15,17 @@ concurrency:
|
|||||||
cancel-in-progress: true
|
cancel-in-progress: true
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
lint:
|
test:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- name: Checkout
|
- name: Checkout
|
||||||
uses: actions/checkout@v4
|
uses: actions/checkout@v3
|
||||||
|
|
||||||
- name: Setup Node.JS
|
- name: Setup Node.JS
|
||||||
uses: actions/setup-node@v4
|
uses: actions/setup-node@v3
|
||||||
with:
|
with:
|
||||||
node-version-file: '.node-version'
|
node-version: 16.x
|
||||||
cache: npm
|
cache: 'npm'
|
||||||
|
|
||||||
- name: Install dependencies
|
- name: Install dependencies
|
||||||
run: npm ci
|
run: npm ci
|
||||||
|
|||||||
12
.github/workflows/codeql-analysis.yml
vendored
12
.github/workflows/codeql-analysis.yml
vendored
@@ -9,7 +9,7 @@
|
|||||||
# the `language` matrix defined below to confirm you have the correct set of
|
# the `language` matrix defined below to confirm you have the correct set of
|
||||||
# supported CodeQL languages.
|
# supported CodeQL languages.
|
||||||
#
|
#
|
||||||
name: CodeQL
|
name: 'CodeQL'
|
||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
@@ -37,12 +37,12 @@ jobs:
|
|||||||
# Learn more about CodeQL language support at https://git.io/codeql-language-support
|
# Learn more about CodeQL language support at https://git.io/codeql-language-support
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- name: Checkout
|
- name: Checkout repository
|
||||||
uses: actions/checkout@v4
|
uses: actions/checkout@v3
|
||||||
|
|
||||||
# Initializes the CodeQL tools for scanning.
|
# Initializes the CodeQL tools for scanning.
|
||||||
- name: Initialize CodeQL
|
- name: Initialize CodeQL
|
||||||
uses: github/codeql-action/init@v3
|
uses: github/codeql-action/init@v2
|
||||||
with:
|
with:
|
||||||
languages: ${{ matrix.language }}
|
languages: ${{ matrix.language }}
|
||||||
# If you wish to specify custom queries, you can do so here or in a config file.
|
# If you wish to specify custom queries, you can do so here or in a config file.
|
||||||
@@ -53,7 +53,7 @@ jobs:
|
|||||||
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
|
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
|
||||||
# If this step fails, then you should remove it and run the build manually (see below)
|
# If this step fails, then you should remove it and run the build manually (see below)
|
||||||
- name: Autobuild
|
- name: Autobuild
|
||||||
uses: github/codeql-action/autobuild@v3
|
uses: github/codeql-action/autobuild@v2
|
||||||
|
|
||||||
# ℹ️ Command-line programs to run using the OS shell.
|
# ℹ️ Command-line programs to run using the OS shell.
|
||||||
# 📚 https://git.io/JvXDl
|
# 📚 https://git.io/JvXDl
|
||||||
@@ -67,4 +67,4 @@ jobs:
|
|||||||
# make release
|
# make release
|
||||||
|
|
||||||
- name: Perform CodeQL Analysis
|
- name: Perform CodeQL Analysis
|
||||||
uses: github/codeql-action/analyze@v3
|
uses: github/codeql-action/analyze@v2
|
||||||
|
|||||||
16
.github/workflows/draft-release.yml
vendored
16
.github/workflows/draft-release.yml
vendored
@@ -1,16 +0,0 @@
|
|||||||
name: Draft release
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- main
|
|
||||||
|
|
||||||
permissions:
|
|
||||||
contents: write
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
draft-release:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: release-drafter/release-drafter@09c613e259eb8d4e7c81c2cb00618eb5fc4575a7 # v5.25.0
|
|
||||||
env:
|
|
||||||
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
|
||||||
51
.github/workflows/rebuild-dependabot-prs.yml
vendored
51
.github/workflows/rebuild-dependabot-prs.yml
vendored
@@ -1,51 +0,0 @@
|
|||||||
name: Rebuild distributables for Dependabot PRs
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- 'dependabot/npm**'
|
|
||||||
|
|
||||||
# No permissions needed for `GITHUB_TOKEN` since we're using a PAT instead
|
|
||||||
permissions: {}
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
rebuild-dist:
|
|
||||||
if: ${{ github.event.sender.login == 'dependabot[bot]' }}
|
|
||||||
|
|
||||||
# This allows a subsequently queued workflow run to interrupt previous runs.
|
|
||||||
# It is evaluated AFTER the job's `if` condition, so a push triggered by this
|
|
||||||
# workflow's PAT will NOT interrupt a run triggered by a push from Dependabot.
|
|
||||||
concurrency:
|
|
||||||
group: '${{ github.workflow }} / ${{ github.job }} @ ${{ github.ref }}'
|
|
||||||
cancel-in-progress: true
|
|
||||||
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- name: Checkout
|
|
||||||
uses: actions/checkout@v4
|
|
||||||
with:
|
|
||||||
token: ${{ secrets.PAGES_AUTOMATION_PAT }}
|
|
||||||
|
|
||||||
- name: Setup Node.JS
|
|
||||||
uses: actions/setup-node@v4
|
|
||||||
with:
|
|
||||||
node-version-file: '.node-version'
|
|
||||||
cache: npm
|
|
||||||
|
|
||||||
- name: Install dependencies
|
|
||||||
run: npm ci
|
|
||||||
|
|
||||||
- name: Rebuild the dist/ directory
|
|
||||||
run: npm run prepare
|
|
||||||
|
|
||||||
- name: Commit any differences present in the dist/ directory
|
|
||||||
run: |
|
|
||||||
if [ "$(git diff --ignore-space-at-eol dist/ | wc -l)" -gt "0" ]; then
|
|
||||||
echo "Detected uncommitted changes after rebuild in dist folder. Committing..."
|
|
||||||
git add dist/
|
|
||||||
git config --local user.name "github-actions[bot]"
|
|
||||||
git config --local user.email "github-actions[bot]@users.noreply.github.com"
|
|
||||||
git commit -m "Update distributables after Dependabot 🤖"
|
|
||||||
echo "Pushing branch ${{ github.ref_name }}"
|
|
||||||
git push origin ${{ github.ref_name }}
|
|
||||||
fi
|
|
||||||
2
.github/workflows/release.yml
vendored
2
.github/workflows/release.yml
vendored
@@ -24,7 +24,7 @@ jobs:
|
|||||||
steps:
|
steps:
|
||||||
- name: Update the ${{ env.TAG_NAME }} tag
|
- name: Update the ${{ env.TAG_NAME }} tag
|
||||||
id: update-major-tag
|
id: update-major-tag
|
||||||
uses: actions/publish-action@v0.3.0
|
uses: actions/publish-action@v0.1.0
|
||||||
with:
|
with:
|
||||||
source-tag: ${{ env.TAG_NAME }}
|
source-tag: ${{ env.TAG_NAME }}
|
||||||
slack-webhook: ${{ secrets.SLACK_WEBHOOK }}
|
slack-webhook: ${{ secrets.SLACK_WEBHOOK }}
|
||||||
|
|||||||
23
.github/workflows/test.yml
vendored
23
.github/workflows/test.yml
vendored
@@ -1,29 +1,28 @@
|
|||||||
name: Run tests
|
name: Run Tests
|
||||||
|
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches:
|
branches:
|
||||||
- main
|
- main
|
||||||
pull_request:
|
pull_request:
|
||||||
|
|
||||||
permissions:
|
|
||||||
contents: read
|
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
test:
|
test:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- name: Checkout
|
- name: Checkout
|
||||||
uses: actions/checkout@v4
|
uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Setup Node.JS
|
- name: Set Node.JS
|
||||||
uses: actions/setup-node@v4
|
uses: actions/setup-node@v2
|
||||||
with:
|
with:
|
||||||
node-version-file: '.node-version'
|
node-version: 16.x
|
||||||
cache: npm
|
|
||||||
|
|
||||||
- name: Install dependencies
|
- name: Install dependencies
|
||||||
run: npm ci
|
run: npm install
|
||||||
|
|
||||||
- name: Run tests
|
- name: Run tests
|
||||||
run: npm run test
|
run: npm run test
|
||||||
|
# Drafts your next Release notes as Pull Requests are merged into "main"
|
||||||
|
- uses: release-drafter/release-drafter@v5
|
||||||
|
if: github.ref_name == 'main'
|
||||||
|
env:
|
||||||
|
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
|||||||
2
.gitignore
vendored
2
.gitignore
vendored
@@ -64,4 +64,4 @@ typings/
|
|||||||
.env
|
.env
|
||||||
|
|
||||||
# next.js build output
|
# next.js build output
|
||||||
.next
|
.next
|
||||||
@@ -1 +0,0 @@
|
|||||||
20.10.0
|
|
||||||
1
CODEOWNERS
Normal file
1
CODEOWNERS
Normal file
@@ -0,0 +1 @@
|
|||||||
|
* @actions/pages
|
||||||
@@ -1,29 +0,0 @@
|
|||||||
# Contributing 💻
|
|
||||||
|
|
||||||
All contributions are welcome and greatly appreciated!
|
|
||||||
|
|
||||||
## Steps to Contribute 💡
|
|
||||||
|
|
||||||
> Check the `.node-version` file in the root of this repo so see what version of Node.js is required for local development - note, this can be different from the version of Node.js which runs the Action on GitHub runners. It is suggested to download [nodenv](https://github.com/nodenv/nodenv) which uses this file and manages your Node.js versions for you
|
|
||||||
|
|
||||||
1. Fork this repository
|
|
||||||
2. Make your changes
|
|
||||||
3. [Test](#testing-) your changes locally
|
|
||||||
4. Before opening a pull request, please run `npm run all` to verify formatting, linting, tests, generated files, etc.
|
|
||||||
5. Commit and push your changes to your fork
|
|
||||||
6. Open a pull request back to this repository
|
|
||||||
7. Wait for an approval or changes requested from the maintainers of this repository
|
|
||||||
|
|
||||||
After merging the pull request, the maintainers of this repository will create a new release with those changes included. After that, everyone can utilize the newly integrated changes in their own Actions workflows and enjoy your awesome improvements!
|
|
||||||
|
|
||||||
## Testing 🧪
|
|
||||||
|
|
||||||
### Running the test suite (required)
|
|
||||||
|
|
||||||
Simply run the following command to execute the entire test suite:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm test
|
|
||||||
```
|
|
||||||
|
|
||||||
> Note: This requires that you have already run `npm install`.
|
|
||||||
64
README.md
64
README.md
@@ -1,16 +1,18 @@
|
|||||||
# deploy-pages 🚀
|
# deploy-pages
|
||||||
|
|
||||||
[](https://github.com/actions/deploy-pages/releases/latest) [](https://github.com/actions/deploy-pages/actions/workflows/check-linter.yml) [](https://github.com/actions/deploy-pages/actions/workflows/check-formatting.yml) [](https://github.com/actions/deploy-pages/actions/workflows/test.yml)  [](https://github.com/actions/deploy-pages/actions/workflows/check-dist.yml) [](https://github.com/actions/deploy-pages/actions/workflows/codeql-analysis.yml)
|
This action is used to deploy [Actions artifacts][artifacts] to GitHub Pages.
|
||||||
|
|
||||||
This action is used to deploy [Actions artifacts][artifacts] to [GitHub Pages](https://pages.github.com/).
|
## Scope
|
||||||
|
|
||||||
|
⚠️ Official support for building Pages with Actions is in public beta at the moment.
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
See [action.yml](action.yml) for the various `inputs` this action supports (or [below](#inputs-📥)).
|
See [action.yml](action.yml) for the various `inputs` this action supports.
|
||||||
|
|
||||||
For examples that make use of this action, check out our [starter-workflows][starter-workflows] in a variety of frameworks.
|
For examples that make use of this action, check out our [starter-workflows][starter-workflows] in a variety of frameworks.
|
||||||
|
|
||||||
This action deploys a Pages site previously uploaded as an artifact (e.g. using [`actions/upload-pages-artifact`][upload-pages-artifact]).
|
This action expects an artifact named `github-pages` to have been created prior to execution. This is done automatically using [`actions/upload-pages-artifact`][upload-pages-artifact].
|
||||||
|
|
||||||
We recommend this action to be used in a dedicated job:
|
We recommend this action to be used in a dedicated job:
|
||||||
|
|
||||||
@@ -41,37 +43,14 @@ jobs:
|
|||||||
steps:
|
steps:
|
||||||
- name: Deploy to GitHub Pages
|
- name: Deploy to GitHub Pages
|
||||||
id: deployment
|
id: deployment
|
||||||
uses: actions/deploy-pages@v4 # or specific "vX.X.X" version tag for this action
|
uses: actions/deploy-pages@v1
|
||||||
```
|
```
|
||||||
|
|
||||||
### Inputs 📥
|
## Security considerations
|
||||||
|
|
||||||
| Input | Required? | Default | Description |
|
|
||||||
| ----- | --------- | ------- | ----------- |
|
|
||||||
| `token` | `true` | `${{ github.token }}` | The GitHub token used to create an authenticated client - Provided for you by default! |
|
|
||||||
| `timeout` | `false` | `"600000"` | Time in milliseconds after which to timeout and cancel the deployment (default: 10 minutes) |
|
|
||||||
| `error_count` | `false` | `"10"` | Maximum number of status report errors before cancelling a deployment (default: 10) |
|
|
||||||
| `reporting_interval` | `false` | `"5000"` | Time in milliseconds between two deployment status reports (default: 5 seconds) |
|
|
||||||
| `artifact_name` | `false` | `"github-pages"` | The name of the artifact to deploy |
|
|
||||||
| `preview` | `false` | `"false"` | Is this attempting to deploy a pull request as a GitHub Pages preview site? (NOTE: This feature is only in alpha currently and is not available to the public!) |
|
|
||||||
|
|
||||||
### Outputs 📤
|
|
||||||
|
|
||||||
| Output | Description |
|
|
||||||
| ------ | ----------- |
|
|
||||||
| `page_url` | The URL of the deployed Pages site |
|
|
||||||
|
|
||||||
### Environment Variables 🌎
|
|
||||||
|
|
||||||
| Variable | Description |
|
|
||||||
| -------- | ----------- |
|
|
||||||
| `GITHUB_PAGES` | This environment variable is created and set to the string value `"true"` so that framework build tools may choose to differentiate their output based on the intended target hosting platform. |
|
|
||||||
|
|
||||||
## Security Considerations
|
|
||||||
|
|
||||||
There are a few important considerations to be aware of:
|
There are a few important considerations to be aware of:
|
||||||
|
|
||||||
1. The artifact being deployed must have been uploaded in a previous step, either in the same job or a separate job that doesn't execute until the upload is complete. See [`actions/upload-pages-artifact`][upload-pages-artifact] for more information about the format of the artifact we expect.
|
1. The artifact being deployed must have been uploaded in a previous step, either in the same job or a separate job that doesn't execute until the upload is complete.
|
||||||
|
|
||||||
2. The job that executes the deployment must at minimum have the following permissions:
|
2. The job that executes the deployment must at minimum have the following permissions:
|
||||||
- `pages: write`
|
- `pages: write`
|
||||||
@@ -81,26 +60,9 @@ There are a few important considerations to be aware of:
|
|||||||
|
|
||||||
4. If your Pages site is using a source branch, the deployment must originate from this source branch unless [your environment is protected][environment-protection] in which case the environment protection rules take precedence over the source branch rule
|
4. If your Pages site is using a source branch, the deployment must originate from this source branch unless [your environment is protected][environment-protection] in which case the environment protection rules take precedence over the source branch rule
|
||||||
|
|
||||||
5. If your Pages site is using GitHub Actions as the source, while not required we highly recommend you also [protect your environment][environment-protection] (we will configure it by default for you).
|
5. If your Pages site is using GitHub Actions as the source, while not required we highly recommend you also [protect your environment][environment-protection] (we do it by default for you)
|
||||||
|
|
||||||
## Compatibility
|
# Release instructions
|
||||||
|
|
||||||
This action is primarily designed for use with GitHub.com's Actions workflows and Pages deployments. However, certain releases should also be compatible with GitHub Enterprise Server (GHES) `3.7` and above.
|
|
||||||
|
|
||||||
| Release | GHES Compatibility |
|
|
||||||
|:---|:---|
|
|
||||||
| [`v4`](https://github.com/actions/deploy-pages/releases/tag/v4) | :warning: Incompatible at this time |
|
|
||||||
| [`v3`](https://github.com/actions/deploy-pages/releases/tag/v3) | `>= 3.9` |
|
|
||||||
| `v3.x.x` | `>= 3.9` |
|
|
||||||
| [`v2`](https://github.com/actions/deploy-pages/releases/tag/v2) | `>= 3.9` |
|
|
||||||
| `v2.x.x` | `>= 3.9` |
|
|
||||||
| [`v1`](https://github.com/actions/deploy-pages/releases/tag/v1) | `>= 3.7` |
|
|
||||||
| [`v1.2.8`](https://github.com/actions/deploy-pages/releases/tag/v1.2.8) | `>= 3.7` |
|
|
||||||
| [`v1.2.7`](https://github.com/actions/deploy-pages/releases/tag/v1.2.7) | :warning: `>= 3.9` [Incompatible with prior versions!](https://github.com/actions/deploy-pages/issues/137) |
|
|
||||||
| [`v1.2.6`](https://github.com/actions/deploy-pages/releases/tag/v1.2.6) | `>= 3.7` |
|
|
||||||
| `v1.x.x` | `>= 3.7` |
|
|
||||||
|
|
||||||
## Release Instructions
|
|
||||||
|
|
||||||
In order to release a new version of this Action:
|
In order to release a new version of this Action:
|
||||||
|
|
||||||
@@ -108,7 +70,7 @@ In order to release a new version of this Action:
|
|||||||
|
|
||||||
2. Publish the draft release from the `main` branch with semantic version as the tag name, _with_ the checkbox to publish to the GitHub Marketplace checked. :ballot_box_with_check:
|
2. Publish the draft release from the `main` branch with semantic version as the tag name, _with_ the checkbox to publish to the GitHub Marketplace checked. :ballot_box_with_check:
|
||||||
|
|
||||||
3. After publishing the release, the [`release` workflow][release] will automatically run to create/update the corresponding major version tag such as `v1`.
|
3. After publishing the release, the [`release` workflow][release] will automatically run to create/update the corresponding the major version tag such as `v1`.
|
||||||
|
|
||||||
⚠️ Environment approval is required. Check the [Release workflow run list][release-workflow-runs].
|
⚠️ Environment approval is required. Check the [Release workflow run list][release-workflow-runs].
|
||||||
|
|
||||||
|
|||||||
10
action.yml
10
action.yml
@@ -2,9 +2,17 @@ name: 'Deploy GitHub Pages site'
|
|||||||
description: 'A GitHub Action to deploy an artifact as a GitHub Pages site'
|
description: 'A GitHub Action to deploy an artifact as a GitHub Pages site'
|
||||||
author: 'GitHub'
|
author: 'GitHub'
|
||||||
runs:
|
runs:
|
||||||
using: 'node20'
|
using: 'node16'
|
||||||
main: 'dist/index.js'
|
main: 'dist/index.js'
|
||||||
inputs:
|
inputs:
|
||||||
|
emit_telemetry:
|
||||||
|
deprecationMessage: 'Use of this input causes the action to do nothing. You should remove this build step from your workflow.'
|
||||||
|
description: 'Should this action only emit build telemetry instead of deploying the build artifact?'
|
||||||
|
required: false
|
||||||
|
default: 'false'
|
||||||
|
conclusion:
|
||||||
|
description: 'The status of the previous build.'
|
||||||
|
required: false
|
||||||
token:
|
token:
|
||||||
description: 'GitHub token'
|
description: 'GitHub token'
|
||||||
default: ${{ github.token }}
|
default: ${{ github.token }}
|
||||||
|
|||||||
@@ -1 +0,0 @@
|
|||||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="116" height="20" role="img" aria-label="Coverage: 81.13%"><title>Coverage: 81.13%</title><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="116" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="63" height="20" fill="#555"/><rect x="63" width="53" height="20" fill="#dfb317"/><rect width="116" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text aria-hidden="true" x="325" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="530">Coverage</text><text x="325" y="140" transform="scale(.1)" fill="#fff" textLength="530">Coverage</text><text aria-hidden="true" x="885" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">81.13%</text><text x="885" y="140" transform="scale(.1)" fill="#fff" textLength="430">81.13%</text></g></svg>
|
|
||||||
|
Before Width: | Height: | Size: 1.1 KiB |
150065
dist/index.js
vendored
150065
dist/index.js
vendored
File diff suppressed because one or more lines are too long
2
dist/index.js.map
vendored
2
dist/index.js.map
vendored
File diff suppressed because one or more lines are too long
3239
dist/licenses.txt
vendored
3239
dist/licenses.txt
vendored
File diff suppressed because it is too large
Load Diff
2
dist/sourcemap-register.js
vendored
2
dist/sourcemap-register.js
vendored
File diff suppressed because one or more lines are too long
10560
package-lock.json
generated
10560
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
48
package.json
48
package.json
@@ -1,29 +1,24 @@
|
|||||||
{
|
{
|
||||||
"name": "deploy-pages",
|
"name": "deploy-pages",
|
||||||
"version": "0.0.0",
|
"version": "0.0.1",
|
||||||
"description": "Deploy an actions artifact to GitHub Pages",
|
"description": "Deploy an actions artifact to GitHub Pages",
|
||||||
"main": "./dist/index.js",
|
"main": "./dist/index.js",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@actions/artifact": "^2.0.0",
|
"@actions/core": "^1.10.0",
|
||||||
"@actions/core": "^1.10.1",
|
"axios": "^0.24.0",
|
||||||
"@actions/github": "^6.0.0",
|
"axios-retry": "^3.2.4"
|
||||||
"@octokit/request-error": "^5.0.1",
|
|
||||||
"http-status-messages": "^1.1.0"
|
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@vercel/ncc": "^0.38.1",
|
"@vercel/ncc": "^0.31.1",
|
||||||
"eslint": "^8.56.0",
|
"eslint": "^8.2.0",
|
||||||
"eslint-config-prettier": "^9.1.0",
|
"eslint-config-prettier": "^8.3.0",
|
||||||
"eslint-plugin-github": "^4.10.1",
|
"eslint-plugin-github": "^4.3.4",
|
||||||
"jest": "^29.7.0",
|
"jest": "^27.3.1",
|
||||||
"make-coverage-badge": "^1.2.0",
|
"nock": "^13.2.0",
|
||||||
"nock": "^13.4.0",
|
"prettier": "^2.4.1"
|
||||||
"prettier": "^3.1.0",
|
|
||||||
"undici": "^6.2.1"
|
|
||||||
},
|
},
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"all": "npm run format && npm run lint && npm run prepare && npm run test && npm run coverage-badge",
|
"all": "npm run format && npm run lint && npm run prepare && npm run test",
|
||||||
"coverage-badge": "make-coverage-badge --output-path ./coverage_badge.svg",
|
|
||||||
"format": "prettier --write .",
|
"format": "prettier --write .",
|
||||||
"format:check": "prettier --check .",
|
"format:check": "prettier --check .",
|
||||||
"lint": "DEBUG=eslint:cli-engine eslint --fix .",
|
"lint": "DEBUG=eslint:cli-engine eslint --fix .",
|
||||||
@@ -44,22 +39,5 @@
|
|||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/actions/deploy-pages/issues"
|
"url": "https://github.com/actions/deploy-pages/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/actions/deploy-pages#readme",
|
"homepage": "https://github.com/actions/deploy-pages#readme"
|
||||||
"jest": {
|
|
||||||
"coverageReporters": [
|
|
||||||
"json-summary",
|
|
||||||
"text",
|
|
||||||
"lcov"
|
|
||||||
],
|
|
||||||
"collectCoverage": true,
|
|
||||||
"collectCoverageFrom": [
|
|
||||||
"./src/**"
|
|
||||||
],
|
|
||||||
"coverageThreshold": {
|
|
||||||
"global": {
|
|
||||||
"lines": 70,
|
|
||||||
"statements": 70
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,36 +0,0 @@
|
|||||||
const process = require('process')
|
|
||||||
const cp = require('child_process')
|
|
||||||
const path = require('path')
|
|
||||||
|
|
||||||
describe('with all environment variables set', () => {
|
|
||||||
beforeEach(() => {
|
|
||||||
process.env.GITHUB_RUN_ID = '123'
|
|
||||||
process.env.GITHUB_REPOSITORY = 'actions/is-awesome'
|
|
||||||
process.env.GITHUB_TOKEN = 'gha-token'
|
|
||||||
process.env.GITHUB_SHA = '123abc'
|
|
||||||
process.env.GITHUB_ACTOR = 'monalisa'
|
|
||||||
process.env.GITHUB_ACTION = '__monalisa/octocat'
|
|
||||||
process.env.GITHUB_ACTION_PATH = 'something'
|
|
||||||
})
|
|
||||||
|
|
||||||
it('executes cleanly', done => {
|
|
||||||
const ip = path.join(__dirname, '../index.js')
|
|
||||||
cp.exec(`node ${ip}`, { env: process.env }, (err, stdout) => {
|
|
||||||
expect(stdout).toMatch(/::debug::all variables are set/)
|
|
||||||
done()
|
|
||||||
})
|
|
||||||
})
|
|
||||||
})
|
|
||||||
|
|
||||||
describe('with variables missing', () => {
|
|
||||||
it('execution fails if there are missing variables', done => {
|
|
||||||
delete process.env.GITHUB_RUN_ID
|
|
||||||
const ip = path.join(__dirname, '../index.js')
|
|
||||||
cp.exec(`node ${ip}`, { env: process.env }, (err, stdout) => {
|
|
||||||
expect(stdout).toBe('')
|
|
||||||
expect(err).toBeTruthy()
|
|
||||||
expect(err.code).toBe(1)
|
|
||||||
done()
|
|
||||||
})
|
|
||||||
})
|
|
||||||
})
|
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -3,15 +3,16 @@ const core = require('@actions/core')
|
|||||||
// Load variables from Actions runtime
|
// Load variables from Actions runtime
|
||||||
function getRequiredVars() {
|
function getRequiredVars() {
|
||||||
return {
|
return {
|
||||||
|
runTimeUrl: process.env.ACTIONS_RUNTIME_URL,
|
||||||
workflowRun: process.env.GITHUB_RUN_ID,
|
workflowRun: process.env.GITHUB_RUN_ID,
|
||||||
|
runTimeToken: process.env.ACTIONS_RUNTIME_TOKEN,
|
||||||
repositoryNwo: process.env.GITHUB_REPOSITORY,
|
repositoryNwo: process.env.GITHUB_REPOSITORY,
|
||||||
buildVersion: process.env.GITHUB_SHA,
|
buildVersion: process.env.GITHUB_SHA,
|
||||||
buildActor: process.env.GITHUB_ACTOR,
|
buildActor: process.env.GITHUB_ACTOR,
|
||||||
actionsId: process.env.GITHUB_ACTION,
|
actionsId: process.env.GITHUB_ACTION,
|
||||||
githubToken: core.getInput('token'),
|
githubToken: core.getInput('token'),
|
||||||
githubApiUrl: process.env.GITHUB_API_URL ?? 'https://api.github.com',
|
githubApiUrl: process.env.GITHUB_API_CUSTOM_URL ?? process.env.GITHUB_API_URL ?? 'https://api.github.com',
|
||||||
githubServerUrl: process.env.GITHUB_SERVER_URL ?? 'https://github.com',
|
artifactName: core.getInput('artifact_name') ?? 'github-pages',
|
||||||
artifactName: core.getInput('artifact_name') || 'github-pages',
|
|
||||||
isPreview: core.getInput('preview') === 'true'
|
isPreview: core.getInput('preview') === 'true'
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
234
src/deployment.js
Normal file
234
src/deployment.js
Normal file
@@ -0,0 +1,234 @@
|
|||||||
|
const core = require('@actions/core')
|
||||||
|
const axios = require('axios')
|
||||||
|
|
||||||
|
// All variables we need from the runtime are loaded here
|
||||||
|
const getContext = require('./context')
|
||||||
|
|
||||||
|
const errorStatus = {
|
||||||
|
unknown_status: 'Unable to get deployment status.',
|
||||||
|
not_found: 'Deployment not found.',
|
||||||
|
deployment_attempt_error: 'Deployment temporarily failed, a retry will be automatically scheduled...'
|
||||||
|
}
|
||||||
|
|
||||||
|
class Deployment {
|
||||||
|
constructor() {
|
||||||
|
const context = getContext()
|
||||||
|
this.runTimeUrl = context.runTimeUrl
|
||||||
|
this.repositoryNwo = context.repositoryNwo
|
||||||
|
this.runTimeToken = context.runTimeToken
|
||||||
|
this.buildVersion = context.buildVersion
|
||||||
|
this.buildActor = context.buildActor
|
||||||
|
this.actionsId = context.workflowRun
|
||||||
|
this.githubToken = context.githubToken
|
||||||
|
this.workflowRun = context.workflowRun
|
||||||
|
this.requestedDeployment = false
|
||||||
|
this.deploymentInfo = null
|
||||||
|
this.githubApiUrl = context.githubApiUrl
|
||||||
|
this.artifactName = context.artifactName
|
||||||
|
this.isPreview = context.isPreview === true
|
||||||
|
}
|
||||||
|
|
||||||
|
// Ask the runtime for the unsigned artifact URL and deploy to GitHub Pages
|
||||||
|
// by creating a deployment with that artifact
|
||||||
|
async create(idToken) {
|
||||||
|
try {
|
||||||
|
core.info(`Actor: ${this.buildActor}`)
|
||||||
|
core.info(`Action ID: ${this.actionsId}`)
|
||||||
|
const pagesDeployEndpoint = `${this.githubApiUrl}/repos/${this.repositoryNwo}/pages/deployment`
|
||||||
|
const artifactExgUrl = `${this.runTimeUrl}_apis/pipelines/workflows/${this.workflowRun}/artifacts?api-version=6.0-preview`
|
||||||
|
core.info(`Artifact URL: ${artifactExgUrl}`)
|
||||||
|
const { data } = await axios.get(artifactExgUrl, {
|
||||||
|
headers: {
|
||||||
|
Authorization: `Bearer ${this.runTimeToken}`,
|
||||||
|
'Content-Type': 'application/json'
|
||||||
|
}
|
||||||
|
})
|
||||||
|
core.info(JSON.stringify(data))
|
||||||
|
const artifactRawUrl = data?.value?.find(artifact => artifact.name === this.artifactName)?.url
|
||||||
|
if (!artifactRawUrl) {
|
||||||
|
throw new Error(
|
||||||
|
'No uploaded artifact was found! Please check if there are any errors at build step, or uploaded artifact name is correct.'
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
const artifactUrl = `${artifactRawUrl}&%24expand=SignedContent`
|
||||||
|
const payload = {
|
||||||
|
artifact_url: artifactUrl,
|
||||||
|
pages_build_version: this.buildVersion,
|
||||||
|
oidc_token: idToken
|
||||||
|
}
|
||||||
|
if (this.isPreview === true) {
|
||||||
|
payload.preview = true
|
||||||
|
}
|
||||||
|
core.info(`Creating deployment with payload:\n${JSON.stringify(payload, null, '\t')}`)
|
||||||
|
core.info(`Sending payload to: ${pagesDeployEndpoint}`)
|
||||||
|
core.info(`It should be sent do: ${process.env.GITHUB_API_CUSTOM_URL}`)
|
||||||
|
const response = await axios.post(pagesDeployEndpoint, payload, {
|
||||||
|
headers: {
|
||||||
|
Accept: 'application/vnd.github.v3+json',
|
||||||
|
Authorization: `Bearer ${this.githubToken}`,
|
||||||
|
'Content-type': 'application/json',
|
||||||
|
Host: 'api.github.com'
|
||||||
|
}
|
||||||
|
})
|
||||||
|
this.requestedDeployment = true
|
||||||
|
core.info(`Created deployment for ${this.buildVersion}`)
|
||||||
|
if (response && response.data) {
|
||||||
|
core.info(JSON.stringify(response.data))
|
||||||
|
this.deploymentInfo = response.data
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
core.info(error.stack)
|
||||||
|
|
||||||
|
// output raw error in debug mode.
|
||||||
|
core.debug(JSON.stringify(error))
|
||||||
|
|
||||||
|
// build customized error message based on server response
|
||||||
|
if (error.response) {
|
||||||
|
let errorMessage = `Failed to create deployment (status: ${error.response.status}) with build version ${this.buildVersion}. `
|
||||||
|
if (error.response.status == 400) {
|
||||||
|
let message = ''
|
||||||
|
if (error.response.data && error.response.data.message) {
|
||||||
|
message = error.response.data.message
|
||||||
|
} else {
|
||||||
|
message = error.response.data
|
||||||
|
}
|
||||||
|
errorMessage += `Responded with: ${message}`
|
||||||
|
} else if (error.response.status == 403) {
|
||||||
|
errorMessage += `Ensure GITHUB_TOKEN has permission "pages: write".`
|
||||||
|
} else if (error.response.status == 404) {
|
||||||
|
errorMessage += `Ensure GitHub Pages has been enabled.`
|
||||||
|
} else if (error.response.status >= 500) {
|
||||||
|
errorMessage += `Server error, is githubstatus.com reporting a Pages outage? Please re-run the deployment at a later time.`
|
||||||
|
}
|
||||||
|
throw errorMessage
|
||||||
|
} else {
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Poll the deployment endpoint for status
|
||||||
|
async check() {
|
||||||
|
try {
|
||||||
|
const statusUrl =
|
||||||
|
this.deploymentInfo != null
|
||||||
|
? this.deploymentInfo['status_url']
|
||||||
|
: `${this.githubApiUrl}/repos/${this.repositoryNwo}/pages/deployment/status/${this.buildVersion}`
|
||||||
|
let pageUrl = this.deploymentInfo != null ? this.deploymentInfo['page_url'] : ''
|
||||||
|
const previewUrl = this.deploymentInfo != null ? this.deploymentInfo['preview_url'] : ''
|
||||||
|
if (this.isPreview && previewUrl) {
|
||||||
|
pageUrl = previewUrl
|
||||||
|
}
|
||||||
|
core.setOutput('page_url', pageUrl)
|
||||||
|
const timeout = Number(core.getInput('timeout'))
|
||||||
|
const reportingInterval = Number(core.getInput('reporting_interval'))
|
||||||
|
const maxErrorCount = Number(core.getInput('error_count'))
|
||||||
|
var startTime = Date.now()
|
||||||
|
var errorCount = 0
|
||||||
|
|
||||||
|
// Time in milliseconds between two deployment status report when status errored, default 0.
|
||||||
|
var errorReportingInterval = 0
|
||||||
|
|
||||||
|
/*eslint no-constant-condition: ["error", { "checkLoops": false }]*/
|
||||||
|
while (true) {
|
||||||
|
// Handle reporting interval
|
||||||
|
await new Promise(r => setTimeout(r, reportingInterval + errorReportingInterval))
|
||||||
|
|
||||||
|
// Check status
|
||||||
|
var res = await axios.get(statusUrl, {
|
||||||
|
headers: {
|
||||||
|
Authorization: `token ${this.githubToken}`
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
if (res.data.status == 'succeed') {
|
||||||
|
core.info('Reported success!')
|
||||||
|
core.setOutput('status', 'succeed')
|
||||||
|
break
|
||||||
|
} else if (res.data.status == 'deployment_failed') {
|
||||||
|
// Fall into permanent error, it may be caused by ongoing incident or malicious deployment content or exhausted automatic retry times.
|
||||||
|
core.setFailed('Deployment failed, try again later.')
|
||||||
|
break
|
||||||
|
} else if (res.data.status == 'deployment_content_failed') {
|
||||||
|
// The uploaded artifact is invalid.
|
||||||
|
core.setFailed(
|
||||||
|
'Artifact could not be deployed. Please ensure the content does not contain any hard links, symlinks and total size is less than 10GB.'
|
||||||
|
)
|
||||||
|
break
|
||||||
|
} else if (errorStatus[res.data.status]) {
|
||||||
|
// A temporary error happened, will query the status again
|
||||||
|
core.info(errorStatus[res.data.status])
|
||||||
|
} else {
|
||||||
|
core.info('Current status: ' + res.data.status)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (res.status != 200 || !!errorStatus[res.data.status]) {
|
||||||
|
errorCount++
|
||||||
|
|
||||||
|
// set the Maximum error reporting interval greater than 15 sec but below 30 sec.
|
||||||
|
if (errorReportingInterval < 1000 * 15) {
|
||||||
|
errorReportingInterval = (errorReportingInterval << 1) | 1
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// reset the error reporting interval once get the proper status back.
|
||||||
|
errorReportingInterval = 0
|
||||||
|
}
|
||||||
|
|
||||||
|
if (errorCount >= maxErrorCount) {
|
||||||
|
core.info('Too many errors, aborting!')
|
||||||
|
core.setFailed('Failed with status code: ' + res.status)
|
||||||
|
|
||||||
|
// Explicitly cancel the deployment
|
||||||
|
await this.cancel()
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Handle timeout
|
||||||
|
if (Date.now() - startTime >= timeout) {
|
||||||
|
core.info('Timeout reached, aborting!')
|
||||||
|
core.setFailed('Timeout reached, aborting!')
|
||||||
|
|
||||||
|
// Explicitly cancel the deployment
|
||||||
|
await this.cancel()
|
||||||
|
return
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
core.setFailed(error)
|
||||||
|
if (error.response && error.response.data) {
|
||||||
|
core.info(JSON.stringify(error.response.data))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async cancel() {
|
||||||
|
// Don't attemp to cancel if no deployment was created
|
||||||
|
if (!this.requestedDeployment) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Cancel the deployment
|
||||||
|
try {
|
||||||
|
const pagesCancelDeployEndpoint = `${this.githubApiUrl}/repos/${this.repositoryNwo}/pages/deployment/cancel/${this.buildVersion}`
|
||||||
|
await axios.put(
|
||||||
|
pagesCancelDeployEndpoint,
|
||||||
|
{},
|
||||||
|
{
|
||||||
|
headers: {
|
||||||
|
Accept: 'application/vnd.github.v3+json',
|
||||||
|
Authorization: `Bearer ${this.githubToken}`,
|
||||||
|
'Content-type': 'application/json'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
core.info(`Deployment cancelled with ${pagesCancelDeployEndpoint}`)
|
||||||
|
} catch (error) {
|
||||||
|
core.setFailed(error)
|
||||||
|
if (error.response && error.response.data) {
|
||||||
|
core.info(JSON.stringify(error.response.data))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
module.exports = { Deployment }
|
||||||
28
src/index.js
28
src/index.js
@@ -3,10 +3,9 @@
|
|||||||
// without the user having to do the tar process themselves.
|
// without the user having to do the tar process themselves.
|
||||||
|
|
||||||
const core = require('@actions/core')
|
const core = require('@actions/core')
|
||||||
|
// const github = require('@actions/github'); // TODO: Not used until we publish API endpoint to the @action/github package
|
||||||
|
|
||||||
const { Deployment } = require('./internal/deployment')
|
const { Deployment } = require('./deployment')
|
||||||
const getContext = require('./internal/context')
|
|
||||||
|
|
||||||
const deployment = new Deployment()
|
const deployment = new Deployment()
|
||||||
|
|
||||||
async function cancelHandler(evtOrExitCodeOrError) {
|
async function cancelHandler(evtOrExitCodeOrError) {
|
||||||
@@ -15,28 +14,16 @@ async function cancelHandler(evtOrExitCodeOrError) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
async function main() {
|
async function main() {
|
||||||
const { isPreview } = getContext()
|
|
||||||
|
|
||||||
let idToken = ''
|
let idToken = ''
|
||||||
try {
|
try {
|
||||||
idToken = await core.getIDToken()
|
idToken = await core.getIDToken()
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.log(error)
|
console.log(error)
|
||||||
core.setFailed(`Ensure GITHUB_TOKEN has permission "id-token: write".`)
|
core.setFailed(`Ensure GITHUB_TOKEN has permission "idToken: write".`)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
try {
|
try {
|
||||||
const deploymentInfo = await deployment.create(idToken)
|
await deployment.create(idToken)
|
||||||
|
|
||||||
// Output the deployed Pages URL
|
|
||||||
let pageUrl = deploymentInfo?.['page_url'] || ''
|
|
||||||
const previewUrl = deploymentInfo?.['preview_url'] || ''
|
|
||||||
if (isPreview && previewUrl) {
|
|
||||||
pageUrl = previewUrl
|
|
||||||
}
|
|
||||||
core.setOutput('page_url', pageUrl)
|
|
||||||
|
|
||||||
await deployment.check()
|
await deployment.check()
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
core.setFailed(error)
|
core.setFailed(error)
|
||||||
@@ -48,4 +35,9 @@ process.on('SIGINT', cancelHandler)
|
|||||||
process.on('SIGTERM', cancelHandler)
|
process.on('SIGTERM', cancelHandler)
|
||||||
|
|
||||||
// Main
|
// Main
|
||||||
main()
|
const emitTelemetry = core.getInput('emit_telemetry')
|
||||||
|
if (emitTelemetry === 'true') {
|
||||||
|
// For compatibility, treat the use of this deprecated input as a no-op
|
||||||
|
} else {
|
||||||
|
main()
|
||||||
|
}
|
||||||
|
|||||||
281
src/index.test.js
Normal file
281
src/index.test.js
Normal file
@@ -0,0 +1,281 @@
|
|||||||
|
const core = require('@actions/core')
|
||||||
|
const process = require('process')
|
||||||
|
const cp = require('child_process')
|
||||||
|
const path = require('path')
|
||||||
|
const nock = require('nock')
|
||||||
|
const axios = require('axios')
|
||||||
|
|
||||||
|
const { Deployment } = require('./deployment')
|
||||||
|
|
||||||
|
describe('with all environment variables set', () => {
|
||||||
|
beforeEach(() => {
|
||||||
|
process.env.ACTIONS_RUNTIME_URL = 'my-url'
|
||||||
|
process.env.GITHUB_RUN_ID = '123'
|
||||||
|
process.env.ACTIONS_RUNTIME_TOKEN = 'a-token'
|
||||||
|
process.env.GITHUB_REPOSITORY = 'actions/is-awesome'
|
||||||
|
process.env.GITHUB_TOKEN = 'gha-token'
|
||||||
|
process.env.GITHUB_SHA = '123abc'
|
||||||
|
process.env.GITHUB_ACTOR = 'monalisa'
|
||||||
|
process.env.GITHUB_ACTION = '__monalisa/octocat'
|
||||||
|
process.env.GITHUB_ACTION_PATH = 'something'
|
||||||
|
})
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
// Remove mock for `core.getInput('preview')`
|
||||||
|
delete process.env.INPUT_PREVIEW
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Executes cleanly', done => {
|
||||||
|
const ip = path.join(__dirname, './index.js')
|
||||||
|
cp.exec(`node ${ip}`, { env: process.env }, (err, stdout) => {
|
||||||
|
expect(stdout).toMatch(/::debug::all variables are set/)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('with variables missing', () => {
|
||||||
|
it('execution fails if there are missing variables', done => {
|
||||||
|
delete process.env.ACTIONS_RUNTIME_URL
|
||||||
|
const ip = path.join(__dirname, './index.js')
|
||||||
|
cp.exec(`node ${ip}`, { env: process.env }, (err, stdout) => {
|
||||||
|
expect(stdout).toBe('')
|
||||||
|
expect(err).toBeTruthy()
|
||||||
|
expect(err.code).toBe(1)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('create', () => {
|
||||||
|
beforeAll(() => {
|
||||||
|
process.env.ACTIONS_RUNTIME_URL = 'http://my-url/'
|
||||||
|
process.env.GITHUB_RUN_ID = '123'
|
||||||
|
process.env.ACTIONS_RUNTIME_TOKEN = 'a-token'
|
||||||
|
process.env.GITHUB_REPOSITORY = 'actions/is-awesome'
|
||||||
|
process.env.GITHUB_TOKEN = 'gha-token'
|
||||||
|
process.env.GITHUB_SHA = '123abc'
|
||||||
|
process.env.GITHUB_ACTOR = 'monalisa'
|
||||||
|
process.env.GITHUB_ACTION = '__monalisa/octocat'
|
||||||
|
process.env.GITHUB_ACTION_PATH = 'something'
|
||||||
|
jest.spyOn(core, 'getInput').mockImplementation(param => {
|
||||||
|
switch (param) {
|
||||||
|
case 'artifact_name':
|
||||||
|
return 'github-pages'
|
||||||
|
case 'token':
|
||||||
|
return process.env.GITHUB_TOKEN
|
||||||
|
default:
|
||||||
|
return process.env[`INPUT_${param.toUpperCase()}`] || ''
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
jest.spyOn(core, 'setOutput').mockImplementation(param => {
|
||||||
|
return param
|
||||||
|
})
|
||||||
|
|
||||||
|
jest.spyOn(core, 'setFailed').mockImplementation(param => {
|
||||||
|
return param
|
||||||
|
})
|
||||||
|
// Mock error/warning/info/debug
|
||||||
|
jest.spyOn(core, 'error').mockImplementation(jest.fn())
|
||||||
|
jest.spyOn(core, 'warning').mockImplementation(jest.fn())
|
||||||
|
jest.spyOn(core, 'info').mockImplementation(jest.fn())
|
||||||
|
jest.spyOn(core, 'debug').mockImplementation(jest.fn())
|
||||||
|
})
|
||||||
|
|
||||||
|
it('can successfully create a deployment', async () => {
|
||||||
|
process.env.GITHUB_SHA = 'valid-build-version'
|
||||||
|
const fakeJwt =
|
||||||
|
'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJiNjllMWIxOC1jOGFiLTRhZGQtOGYxOC03MzVlMzVjZGJhZjAiLCJzdWIiOiJyZXBvOnBhcGVyLXNwYS9taW55aTplbnZpcm9ubWVudDpQcm9kdWN0aW9uIiwiYXVkIjoiaHR0cHM6Ly9naXRodWIuY29tL3BhcGVyLXNwYSIsInJlZiI6InJlZnMvaGVhZHMvbWFpbiIsInNoYSI6ImEyODU1MWJmODdiZDk3NTFiMzdiMmM0YjM3M2MxZjU3NjFmYWM2MjYiLCJyZXBvc2l0b3J5IjoicGFwZXItc3BhL21pbnlpIiwicmVwb3NpdG9yeV9vd25lciI6InBhcGVyLXNwYSIsInJ1bl9pZCI6IjE1NDY0NTkzNjQiLCJydW5fbnVtYmVyIjoiMzQiLCJydW5fYXR0ZW1wdCI6IjIiLCJhY3RvciI6IllpTXlzdHkiLCJ3b3JrZmxvdyI6IkNJIiwiaGVhZF9yZWYiOiIiLCJiYXNlX3JlZiI6IiIsImV2ZW50X25hbWUiOiJwdXNoIiwicmVmX3R5cGUiOiJicmFuY2giLCJlbnZpcm9ubWVudCI6IlByb2R1Y3Rpb24iLCJqb2Jfd29ya2Zsb3dfcmVmIjoicGFwZXItc3BhL21pbnlpLy5naXRodWIvd29ya2Zsb3dzL2JsYW5rLnltbEByZWZzL2hlYWRzL21haW4iLCJpc3MiOiJodHRwczovL3Rva2VuLmFjdGlvbnMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwibmJmIjoxNjM4ODI4MDI4LCJleHAiOjE2Mzg4Mjg5MjgsImlhdCI6MTYzODgyODYyOH0.1wyupfxu1HGoTyIqatYg0hIxy2-0bMO-yVlmLSMuu2w'
|
||||||
|
const scope = nock(`http://my-url`)
|
||||||
|
.get('/_apis/pipelines/workflows/123/artifacts?api-version=6.0-preview')
|
||||||
|
.reply(200, {
|
||||||
|
value: [
|
||||||
|
{ url: 'https://another-artifact.com', name: 'another-artifact' },
|
||||||
|
{ url: 'https://fake-artifact.com', name: 'github-pages' }
|
||||||
|
]
|
||||||
|
})
|
||||||
|
|
||||||
|
core.getIDToken = jest.fn().mockResolvedValue(fakeJwt)
|
||||||
|
axios.post = jest.fn().mockResolvedValue('test')
|
||||||
|
|
||||||
|
// Create the deployment
|
||||||
|
const deployment = new Deployment()
|
||||||
|
await deployment.create(fakeJwt)
|
||||||
|
|
||||||
|
expect(axios.post).toBeCalledWith(
|
||||||
|
'https://api.github.com/repos/actions/is-awesome/pages/deployment',
|
||||||
|
{
|
||||||
|
artifact_url: 'https://fake-artifact.com&%24expand=SignedContent',
|
||||||
|
pages_build_version: 'valid-build-version',
|
||||||
|
oidc_token: fakeJwt
|
||||||
|
},
|
||||||
|
{
|
||||||
|
headers: {
|
||||||
|
Accept: 'application/vnd.github.v3+json',
|
||||||
|
Authorization: `Bearer gha-token`,
|
||||||
|
'Content-type': 'application/json'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
expect(core.setFailed).not.toHaveBeenCalled()
|
||||||
|
expect(core.info).toHaveBeenCalledWith('Created deployment for valid-build-version')
|
||||||
|
|
||||||
|
scope.done()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('can successfully create a preview deployment', async () => {
|
||||||
|
process.env.GITHUB_SHA = 'valid-build-version'
|
||||||
|
const fakeJwt =
|
||||||
|
'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJiNjllMWIxOC1jOGFiLTRhZGQtOGYxOC03MzVlMzVjZGJhZjAiLCJzdWIiOiJyZXBvOnBhcGVyLXNwYS9taW55aTplbnZpcm9ubWVudDpQcm9kdWN0aW9uIiwiYXVkIjoiaHR0cHM6Ly9naXRodWIuY29tL3BhcGVyLXNwYSIsInJlZiI6InJlZnMvaGVhZHMvbWFpbiIsInNoYSI6ImEyODU1MWJmODdiZDk3NTFiMzdiMmM0YjM3M2MxZjU3NjFmYWM2MjYiLCJyZXBvc2l0b3J5IjoicGFwZXItc3BhL21pbnlpIiwicmVwb3NpdG9yeV9vd25lciI6InBhcGVyLXNwYSIsInJ1bl9pZCI6IjE1NDY0NTkzNjQiLCJydW5fbnVtYmVyIjoiMzQiLCJydW5fYXR0ZW1wdCI6IjIiLCJhY3RvciI6IllpTXlzdHkiLCJ3b3JrZmxvdyI6IkNJIiwiaGVhZF9yZWYiOiIiLCJiYXNlX3JlZiI6IiIsImV2ZW50X25hbWUiOiJwdXNoIiwicmVmX3R5cGUiOiJicmFuY2giLCJlbnZpcm9ubWVudCI6IlByb2R1Y3Rpb24iLCJqb2Jfd29ya2Zsb3dfcmVmIjoicGFwZXItc3BhL21pbnlpLy5naXRodWIvd29ya2Zsb3dzL2JsYW5rLnltbEByZWZzL2hlYWRzL21haW4iLCJpc3MiOiJodHRwczovL3Rva2VuLmFjdGlvbnMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwibmJmIjoxNjM4ODI4MDI4LCJleHAiOjE2Mzg4Mjg5MjgsImlhdCI6MTYzODgyODYyOH0.1wyupfxu1HGoTyIqatYg0hIxy2-0bMO-yVlmLSMuu2w'
|
||||||
|
const scope = nock(`http://my-url`)
|
||||||
|
.get('/_apis/pipelines/workflows/123/artifacts?api-version=6.0-preview')
|
||||||
|
.reply(200, {
|
||||||
|
value: [
|
||||||
|
{ url: 'https://another-artifact.com', name: 'another-artifact' },
|
||||||
|
{ url: 'https://fake-artifact.com', name: 'github-pages' }
|
||||||
|
]
|
||||||
|
})
|
||||||
|
|
||||||
|
core.getIDToken = jest.fn().mockResolvedValue(fakeJwt)
|
||||||
|
axios.post = jest.fn().mockResolvedValue('test')
|
||||||
|
|
||||||
|
// Return `"true"` for `core.getInput("preview")`
|
||||||
|
process.env.INPUT_PREVIEW = 'true'
|
||||||
|
|
||||||
|
// Create the deployment
|
||||||
|
const deployment = new Deployment()
|
||||||
|
await deployment.create(fakeJwt)
|
||||||
|
|
||||||
|
expect(axios.post).toBeCalledWith(
|
||||||
|
'https://api.github.com/repos/actions/is-awesome/pages/deployment',
|
||||||
|
{
|
||||||
|
artifact_url: 'https://fake-artifact.com&%24expand=SignedContent',
|
||||||
|
pages_build_version: 'valid-build-version',
|
||||||
|
oidc_token: fakeJwt,
|
||||||
|
preview: true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
headers: {
|
||||||
|
Accept: 'application/vnd.github.v3+json',
|
||||||
|
Authorization: `Bearer gha-token`,
|
||||||
|
'Content-type': 'application/json'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
expect(core.setFailed).not.toHaveBeenCalled()
|
||||||
|
expect(core.info).toHaveBeenCalledWith('Created deployment for valid-build-version')
|
||||||
|
|
||||||
|
scope.done()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Reports errors with failed deployments', async () => {
|
||||||
|
process.env.GITHUB_SHA = 'invalid-build-version'
|
||||||
|
const scope = nock(`http://my-url`)
|
||||||
|
.get('/_apis/pipelines/workflows/123/artifacts?api-version=6.0-preview')
|
||||||
|
.reply(200, { value: [{ url: 'https://invalid-artifact.com', name: 'github-pages' }] })
|
||||||
|
|
||||||
|
axios.post = jest.fn().mockRejectedValue({
|
||||||
|
status: 400
|
||||||
|
})
|
||||||
|
|
||||||
|
// Create the deployment
|
||||||
|
const deployment = new Deployment()
|
||||||
|
try {
|
||||||
|
deployment.create()
|
||||||
|
} catch (err) {
|
||||||
|
expect(axios.post).toBeCalledWith(
|
||||||
|
'https://api.github.com/repos/actions/is-awesome/pages/deployment',
|
||||||
|
{
|
||||||
|
artifact_url: 'https://invalid-artifact.com&%24expand=SignedContent',
|
||||||
|
pages_build_version: 'invalid-build-version'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
headers: {
|
||||||
|
Accept: 'application/vnd.github.v3+json',
|
||||||
|
Authorization: 'Bearer ',
|
||||||
|
'Content-type': 'application/json'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
expect(core.info).toHaveBeenLastCalledWith('Failed to create deployment for invalid-build-version.')
|
||||||
|
expect(core.setFailed).toHaveBeenCalledWith({ status: 400 })
|
||||||
|
|
||||||
|
scope.done()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('check', () => {
|
||||||
|
beforeAll(() => {
|
||||||
|
process.env.ACTIONS_RUNTIME_URL = 'http://my-url/'
|
||||||
|
process.env.GITHUB_RUN_ID = '123'
|
||||||
|
process.env.ACTIONS_RUNTIME_TOKEN = 'a-token'
|
||||||
|
process.env.GITHUB_REPOSITORY = 'actions/is-awesome'
|
||||||
|
process.env.GITHUB_TOKEN = 'gha-token'
|
||||||
|
process.env.GITHUB_SHA = '123abc'
|
||||||
|
process.env.GITHUB_ACTOR = 'monalisa'
|
||||||
|
process.env.GITHUB_ACTION = '__monalisa/octocat'
|
||||||
|
process.env.GITHUB_ACTION_PATH = 'something'
|
||||||
|
process.env.ARTIFACT_NAME = 'github-pages'
|
||||||
|
|
||||||
|
jest.spyOn(core, 'setOutput').mockImplementation(param => {
|
||||||
|
return param
|
||||||
|
})
|
||||||
|
|
||||||
|
jest.spyOn(core, 'setFailed').mockImplementation(param => {
|
||||||
|
return param
|
||||||
|
})
|
||||||
|
// Mock error/warning/info/debug
|
||||||
|
jest.spyOn(core, 'error').mockImplementation(jest.fn())
|
||||||
|
jest.spyOn(core, 'warning').mockImplementation(jest.fn())
|
||||||
|
jest.spyOn(core, 'info').mockImplementation(jest.fn())
|
||||||
|
jest.spyOn(core, 'debug').mockImplementation(jest.fn())
|
||||||
|
})
|
||||||
|
|
||||||
|
it('sets output to success when deployment is successful', async () => {
|
||||||
|
process.env.GITHUB_SHA = 'valid-build-version'
|
||||||
|
let repositoryNwo = process.env.GITHUB_REPOSITORY
|
||||||
|
let buildVersion = process.env.GITHUB_SHA
|
||||||
|
|
||||||
|
// mock a successful call to create a deployment
|
||||||
|
axios.post = jest.fn().mockResolvedValue({ status: 200 })
|
||||||
|
|
||||||
|
// mock a completed deployment with status = 'succeed'
|
||||||
|
axios.get = jest.fn().mockResolvedValue({
|
||||||
|
status: 200,
|
||||||
|
data: {
|
||||||
|
status: 'succeed'
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// Create the deployment
|
||||||
|
const deployment = new Deployment()
|
||||||
|
core.GetInput = jest.fn(input => {
|
||||||
|
switch (input) {
|
||||||
|
case 'timeout':
|
||||||
|
return 10 * 1000
|
||||||
|
case 'reporting_interval':
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
})
|
||||||
|
jest.spyOn(core, 'getInput')
|
||||||
|
await deployment.check()
|
||||||
|
|
||||||
|
expect(axios.get).toBeCalledWith(
|
||||||
|
`https://api.github.com/repos/${repositoryNwo}/pages/deployment/status/${buildVersion}`,
|
||||||
|
{
|
||||||
|
headers: {
|
||||||
|
Authorization: 'token gha-token'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
expect(core.setOutput).toBeCalledWith('status', 'succeed')
|
||||||
|
|
||||||
|
expect(core.info).toHaveBeenCalledWith('Reported success!')
|
||||||
|
})
|
||||||
|
})
|
||||||
@@ -1,179 +0,0 @@
|
|||||||
const core = require('@actions/core')
|
|
||||||
const github = require('@actions/github')
|
|
||||||
const { DefaultArtifactClient } = require('@actions/artifact')
|
|
||||||
const { RequestError } = require('@octokit/request-error')
|
|
||||||
const HttpStatusMessages = require('http-status-messages')
|
|
||||||
|
|
||||||
function wrapTwirpResponseLikeOctokit(twirpResponse, requestOptions) {
|
|
||||||
// Specific response shape aligned with Octokit
|
|
||||||
const response = {
|
|
||||||
url: requestOptions.url,
|
|
||||||
status: 200,
|
|
||||||
headers: {
|
|
||||||
...requestOptions.headers
|
|
||||||
},
|
|
||||||
data: twirpResponse
|
|
||||||
}
|
|
||||||
return response
|
|
||||||
}
|
|
||||||
|
|
||||||
// Mimic the errors thrown by Octokit for consistency.
|
|
||||||
function wrapTwirpErrorLikeOctokit(twirpError, requestOptions) {
|
|
||||||
const rawErrorMsg = twirpError?.message || twirpError?.toString() || ''
|
|
||||||
const statusCodeMatch = rawErrorMsg.match(/Failed request: \((?<statusCode>\d+)\)/)
|
|
||||||
const statusCode = statusCodeMatch?.groups?.statusCode ?? 500
|
|
||||||
|
|
||||||
// Try to provide the best error message
|
|
||||||
const errorMsg =
|
|
||||||
rawErrorMsg ||
|
|
||||||
// Fallback to the HTTP status message based on the status code
|
|
||||||
HttpStatusMessages[statusCode] ||
|
|
||||||
// Or if the status code is unexpected...
|
|
||||||
`Unknown error (${statusCode})`
|
|
||||||
|
|
||||||
// RequestError is an Octokit-specific class
|
|
||||||
return new RequestError(errorMsg, statusCode, {
|
|
||||||
response: {
|
|
||||||
url: requestOptions.url,
|
|
||||||
status: statusCode,
|
|
||||||
headers: {
|
|
||||||
...requestOptions.headers
|
|
||||||
},
|
|
||||||
data: rawErrorMsg ? { message: rawErrorMsg } : ''
|
|
||||||
},
|
|
||||||
request: requestOptions
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
function getArtifactsServiceOrigin() {
|
|
||||||
const resultsUrl = process.env.ACTIONS_RESULTS_URL
|
|
||||||
return resultsUrl ? new URL(resultsUrl).origin : ''
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getArtifactMetadata({ artifactName }) {
|
|
||||||
const artifactClient = new DefaultArtifactClient()
|
|
||||||
|
|
||||||
// Primarily for debugging purposes, accuracy is not critical
|
|
||||||
const requestOptions = {
|
|
||||||
method: 'POST',
|
|
||||||
url: `${getArtifactsServiceOrigin()}/twirp/github.actions.results.api.v1.ArtifactService/ListArtifacts`,
|
|
||||||
headers: {
|
|
||||||
'content-type': 'application/json'
|
|
||||||
},
|
|
||||||
body: {}
|
|
||||||
}
|
|
||||||
|
|
||||||
try {
|
|
||||||
core.info(`Fetching artifact metadata for "${artifactName}" in this workflow run`)
|
|
||||||
|
|
||||||
let response
|
|
||||||
try {
|
|
||||||
const twirpResponse = await artifactClient.listArtifacts()
|
|
||||||
response = wrapTwirpResponseLikeOctokit(twirpResponse, requestOptions)
|
|
||||||
} catch (twirpError) {
|
|
||||||
core.error('Listing artifact metadata failed', twirpError)
|
|
||||||
const octokitError = wrapTwirpErrorLikeOctokit(twirpError, requestOptions)
|
|
||||||
throw octokitError
|
|
||||||
}
|
|
||||||
|
|
||||||
const filteredArtifacts = response.data.artifacts.filter(artifact => artifact.name === artifactName)
|
|
||||||
|
|
||||||
const artifactCount = filteredArtifacts.length
|
|
||||||
core.debug(`List artifact count: ${artifactCount}`)
|
|
||||||
|
|
||||||
if (artifactCount === 0) {
|
|
||||||
throw new Error(
|
|
||||||
`No artifacts named "${artifactName}" were found for this workflow run. Ensure artifacts are uploaded with actions/artifact@v4 or later.`
|
|
||||||
)
|
|
||||||
} else if (artifactCount > 1) {
|
|
||||||
throw new Error(
|
|
||||||
`Multiple artifacts named "${artifactName}" were unexpectedly found for this workflow run. Artifact count is ${artifactCount}.`
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
const artifact = filteredArtifacts[0]
|
|
||||||
core.debug(`Artifact: ${JSON.stringify(artifact)}`)
|
|
||||||
|
|
||||||
if (!artifact.size) {
|
|
||||||
core.warning('Artifact size was not found. Unable to verify if artifact size exceeds the allowed size.')
|
|
||||||
}
|
|
||||||
|
|
||||||
return artifact
|
|
||||||
} catch (error) {
|
|
||||||
core.error(
|
|
||||||
'Fetching artifact metadata failed. Is githubstatus.com reporting issues with API requests, Pages, or Actions? Please re-run the deployment at a later time.',
|
|
||||||
error
|
|
||||||
)
|
|
||||||
throw error
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function createPagesDeployment({ githubToken, artifactId, buildVersion, idToken, isPreview = false }) {
|
|
||||||
const octokit = github.getOctokit(githubToken)
|
|
||||||
|
|
||||||
const payload = {
|
|
||||||
artifact_id: artifactId,
|
|
||||||
pages_build_version: buildVersion,
|
|
||||||
oidc_token: idToken
|
|
||||||
}
|
|
||||||
if (isPreview === true) {
|
|
||||||
payload.preview = true
|
|
||||||
}
|
|
||||||
core.info(`Creating Pages deployment with payload:\n${JSON.stringify(payload, null, '\t')}`)
|
|
||||||
|
|
||||||
try {
|
|
||||||
const response = await octokit.request('POST /repos/{owner}/{repo}/pages/deployments', {
|
|
||||||
owner: github.context.repo.owner,
|
|
||||||
repo: github.context.repo.repo,
|
|
||||||
...payload
|
|
||||||
})
|
|
||||||
|
|
||||||
return response.data
|
|
||||||
} catch (error) {
|
|
||||||
core.error('Creating Pages deployment failed', error)
|
|
||||||
throw error
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function getPagesDeploymentStatus({ githubToken, deploymentId }) {
|
|
||||||
const octokit = github.getOctokit(githubToken)
|
|
||||||
|
|
||||||
core.info('Getting Pages deployment status...')
|
|
||||||
try {
|
|
||||||
const response = await octokit.request('GET /repos/{owner}/{repo}/pages/deployments/{deploymentId}', {
|
|
||||||
owner: github.context.repo.owner,
|
|
||||||
repo: github.context.repo.repo,
|
|
||||||
deploymentId
|
|
||||||
})
|
|
||||||
|
|
||||||
return response.data
|
|
||||||
} catch (error) {
|
|
||||||
core.error('Getting Pages deployment status failed', error)
|
|
||||||
throw error
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async function cancelPagesDeployment({ githubToken, deploymentId }) {
|
|
||||||
const octokit = github.getOctokit(githubToken)
|
|
||||||
|
|
||||||
core.info('Canceling Pages deployment...')
|
|
||||||
try {
|
|
||||||
const response = await octokit.request('POST /repos/{owner}/{repo}/pages/deployments/{deploymentId}/cancel', {
|
|
||||||
owner: github.context.repo.owner,
|
|
||||||
repo: github.context.repo.repo,
|
|
||||||
deploymentId
|
|
||||||
})
|
|
||||||
|
|
||||||
return response.data
|
|
||||||
} catch (error) {
|
|
||||||
core.error('Canceling Pages deployment failed', error)
|
|
||||||
throw error
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
getArtifactMetadata,
|
|
||||||
createPagesDeployment,
|
|
||||||
getPagesDeploymentStatus,
|
|
||||||
cancelPagesDeployment
|
|
||||||
}
|
|
||||||
@@ -1,243 +0,0 @@
|
|||||||
const core = require('@actions/core')
|
|
||||||
|
|
||||||
// All variables we need from the runtime are loaded here
|
|
||||||
const getContext = require('./context')
|
|
||||||
const {
|
|
||||||
getArtifactMetadata,
|
|
||||||
createPagesDeployment,
|
|
||||||
getPagesDeploymentStatus,
|
|
||||||
cancelPagesDeployment
|
|
||||||
} = require('./api-client')
|
|
||||||
|
|
||||||
const temporaryErrorStatus = {
|
|
||||||
unknown_status: 'Unable to get deployment status.',
|
|
||||||
not_found: 'Deployment not found.',
|
|
||||||
deployment_attempt_error: 'Deployment temporarily failed, a retry will be automatically scheduled...'
|
|
||||||
}
|
|
||||||
|
|
||||||
const finalErrorStatus = {
|
|
||||||
deployment_failed: 'Deployment failed, try again later.',
|
|
||||||
deployment_perms_error: 'Deployment failed. Please ensure that the file permissions are correct.',
|
|
||||||
deployment_content_failed:
|
|
||||||
'Artifact could not be deployed. Please ensure the content does not contain any hard links, symlinks and total size is less than 10GB.',
|
|
||||||
deployment_cancelled: 'Deployment cancelled.',
|
|
||||||
deployment_lost: 'Deployment failed to report final status.'
|
|
||||||
}
|
|
||||||
|
|
||||||
const MAX_TIMEOUT = 600000
|
|
||||||
const ONE_GIGABYTE = 1073741824
|
|
||||||
const SIZE_LIMIT_DESCRIPTION = '1 GB'
|
|
||||||
|
|
||||||
class Deployment {
|
|
||||||
constructor() {
|
|
||||||
const context = getContext()
|
|
||||||
this.repositoryNwo = context.repositoryNwo
|
|
||||||
this.buildVersion = context.buildVersion
|
|
||||||
this.buildActor = context.buildActor
|
|
||||||
this.actionsId = context.actionsId
|
|
||||||
this.githubToken = context.githubToken
|
|
||||||
this.workflowRun = context.workflowRun
|
|
||||||
this.deploymentInfo = null
|
|
||||||
this.githubApiUrl = context.githubApiUrl
|
|
||||||
this.githubServerUrl = context.githubServerUrl
|
|
||||||
this.artifactName = context.artifactName
|
|
||||||
this.isPreview = context.isPreview === true
|
|
||||||
this.timeout = MAX_TIMEOUT
|
|
||||||
this.startTime = null
|
|
||||||
}
|
|
||||||
|
|
||||||
// Call GitHub api to fetch artifacts matching the provided name and deploy to GitHub Pages
|
|
||||||
// by creating a deployment with that artifact id
|
|
||||||
async create(idToken) {
|
|
||||||
if (Number(core.getInput('timeout')) > MAX_TIMEOUT) {
|
|
||||||
core.warning(
|
|
||||||
`Warning: timeout value is greater than the allowed maximum - timeout set to the maximum of ${MAX_TIMEOUT} milliseconds.`
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
const timeoutInput = Number(core.getInput('timeout'))
|
|
||||||
this.timeout = !timeoutInput || timeoutInput <= 0 ? MAX_TIMEOUT : Math.min(timeoutInput, MAX_TIMEOUT)
|
|
||||||
|
|
||||||
try {
|
|
||||||
core.debug(`Actor: ${this.buildActor}`)
|
|
||||||
core.debug(`Action ID: ${this.actionsId}`)
|
|
||||||
core.debug(`Actions Workflow Run ID: ${this.workflowRun}`)
|
|
||||||
|
|
||||||
const artifactData = await getArtifactMetadata({ artifactName: this.artifactName })
|
|
||||||
|
|
||||||
if (artifactData?.size > ONE_GIGABYTE) {
|
|
||||||
core.warning(
|
|
||||||
`Uploaded artifact size of ${artifactData?.size} bytes exceeds the allowed size of ${SIZE_LIMIT_DESCRIPTION}. Deployment might fail.`
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
const deployment = await createPagesDeployment({
|
|
||||||
githubToken: this.githubToken,
|
|
||||||
artifactId: artifactData.id,
|
|
||||||
buildVersion: this.buildVersion,
|
|
||||||
idToken,
|
|
||||||
isPreview: this.isPreview
|
|
||||||
})
|
|
||||||
|
|
||||||
if (deployment) {
|
|
||||||
this.deploymentInfo = {
|
|
||||||
...deployment,
|
|
||||||
id: deployment.id || deployment.status_url?.split('/')?.pop() || this.buildVersion,
|
|
||||||
pending: true
|
|
||||||
}
|
|
||||||
this.startTime = Date.now()
|
|
||||||
}
|
|
||||||
|
|
||||||
core.info(`Created deployment for ${this.buildVersion}, ID: ${this.deploymentInfo?.id}`)
|
|
||||||
|
|
||||||
core.debug(JSON.stringify(deployment))
|
|
||||||
|
|
||||||
return deployment
|
|
||||||
} catch (error) {
|
|
||||||
core.error(error.stack)
|
|
||||||
|
|
||||||
// build customized error message based on server response
|
|
||||||
if (error.response) {
|
|
||||||
let errorMessage = `Failed to create deployment (status: ${error.status}) with build version ${this.buildVersion}.`
|
|
||||||
if (error.status === 400) {
|
|
||||||
errorMessage += ` Responded with: ${error.message}`
|
|
||||||
} else if (error.status === 403) {
|
|
||||||
errorMessage += ' Ensure GITHUB_TOKEN has permission "pages: write".'
|
|
||||||
} else if (error.status === 404) {
|
|
||||||
const pagesSettingsUrl = `${this.githubServerUrl}/${this.repositoryNwo}/settings/pages`
|
|
||||||
errorMessage += ` Ensure GitHub Pages has been enabled: ${pagesSettingsUrl}`
|
|
||||||
// If using GHES, add a special note about compatibility
|
|
||||||
if (new URL(this.githubServerUrl).hostname.toLowerCase() !== 'github.com') {
|
|
||||||
errorMessage +=
|
|
||||||
'\nNote: This action version may not yet support GitHub Enterprise Server, please check the compatibility table.'
|
|
||||||
}
|
|
||||||
} else if (error.status >= 500) {
|
|
||||||
errorMessage +=
|
|
||||||
' Server error, is githubstatus.com reporting a Pages outage? Please re-run the deployment at a later time.'
|
|
||||||
}
|
|
||||||
throw new Error(errorMessage)
|
|
||||||
} else {
|
|
||||||
// istanbul ignore next
|
|
||||||
throw error
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Poll the deployment endpoint for status
|
|
||||||
async check() {
|
|
||||||
// Don't attempt to check status if no deployment was created
|
|
||||||
if (!this.deploymentInfo) {
|
|
||||||
core.setFailed(temporaryErrorStatus.not_found)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if (this.deploymentInfo.pending !== true) {
|
|
||||||
core.setFailed(temporaryErrorStatus.unknown_status)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
const deploymentId = this.deploymentInfo.id || this.buildVersion
|
|
||||||
const reportingInterval = Number(core.getInput('reporting_interval'))
|
|
||||||
const maxErrorCount = Number(core.getInput('error_count'))
|
|
||||||
|
|
||||||
let errorCount = 0
|
|
||||||
|
|
||||||
// Time in milliseconds between two deployment status report when status errored, default 0.
|
|
||||||
let errorReportingInterval = 0
|
|
||||||
let deployment = null
|
|
||||||
let errorStatus = 0
|
|
||||||
|
|
||||||
/*eslint no-constant-condition: ["error", { "checkLoops": false }]*/
|
|
||||||
while (true) {
|
|
||||||
// Handle reporting interval
|
|
||||||
await new Promise(resolve => setTimeout(resolve, reportingInterval + errorReportingInterval))
|
|
||||||
|
|
||||||
// Check status
|
|
||||||
try {
|
|
||||||
deployment = await getPagesDeploymentStatus({
|
|
||||||
githubToken: this.githubToken,
|
|
||||||
deploymentId
|
|
||||||
})
|
|
||||||
|
|
||||||
if (deployment.status === 'succeed') {
|
|
||||||
core.info('Reported success!')
|
|
||||||
core.setOutput('status', 'succeed')
|
|
||||||
this.deploymentInfo.pending = false
|
|
||||||
break
|
|
||||||
} else if (finalErrorStatus[deployment.status]) {
|
|
||||||
// Fall into permanent error, it may be caused by ongoing incident, malicious deployment content, exhausted automatic retry times, invalid artifact, etc.
|
|
||||||
core.setFailed(finalErrorStatus[deployment.status])
|
|
||||||
this.deploymentInfo.pending = false
|
|
||||||
break
|
|
||||||
} else if (temporaryErrorStatus[deployment.status]) {
|
|
||||||
// A temporary error happened, will query the status again
|
|
||||||
core.warning(temporaryErrorStatus[deployment.status])
|
|
||||||
} else {
|
|
||||||
core.info('Current status: ' + deployment.status)
|
|
||||||
}
|
|
||||||
|
|
||||||
// reset the error reporting interval once get the proper status back.
|
|
||||||
errorReportingInterval = 0
|
|
||||||
} catch (error) {
|
|
||||||
core.error(error.stack)
|
|
||||||
|
|
||||||
// build customized error message based on server response
|
|
||||||
if (error.response) {
|
|
||||||
errorStatus = error.status || error.response.status
|
|
||||||
|
|
||||||
errorCount++
|
|
||||||
|
|
||||||
// set the maximum error reporting interval greater than 15 sec but below 30 sec.
|
|
||||||
if (errorReportingInterval < 1000 * 15) {
|
|
||||||
errorReportingInterval = (errorReportingInterval << 1) | 1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (errorCount >= maxErrorCount) {
|
|
||||||
core.error('Too many errors, aborting!')
|
|
||||||
core.setFailed('Failed with status code: ' + errorStatus)
|
|
||||||
|
|
||||||
// Explicitly cancel the deployment
|
|
||||||
await this.cancel()
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle timeout
|
|
||||||
if (Date.now() - this.startTime >= this.timeout) {
|
|
||||||
core.error('Timeout reached, aborting!')
|
|
||||||
core.setFailed('Timeout reached, aborting!')
|
|
||||||
|
|
||||||
// Explicitly cancel the deployment
|
|
||||||
await this.cancel()
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async cancel() {
|
|
||||||
// Don't attempt to cancel if no deployment was created
|
|
||||||
if (!this.deploymentInfo || this.deploymentInfo.pending !== true) {
|
|
||||||
core.debug('No deployment to cancel')
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Cancel the deployment
|
|
||||||
try {
|
|
||||||
const deploymentId = this.deploymentInfo.id || this.buildVersion
|
|
||||||
await cancelPagesDeployment({
|
|
||||||
githubToken: this.githubToken,
|
|
||||||
deploymentId
|
|
||||||
})
|
|
||||||
core.info(`Canceled deployment with ID ${deploymentId}`)
|
|
||||||
|
|
||||||
this.deploymentInfo.pending = false
|
|
||||||
} catch (error) {
|
|
||||||
core.setFailed(error)
|
|
||||||
if (error.response?.data) {
|
|
||||||
core.error(JSON.stringify(error.response.data))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
module.exports = { Deployment, MAX_TIMEOUT, ONE_GIGABYTE, SIZE_LIMIT_DESCRIPTION }
|
|
||||||
Reference in New Issue
Block a user