You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
GitHub Action
Astro Deploy
v0.3.2
This action for Astro builds your Astro project for GitHub Pages.
For more information, please see our complete deployment guide—Deploy your Astro Site to GitHub Pages.
Note: Want to get started even faster? Create a repository from our official GitHub Pages template!
path
- Optional: the root location of your Astro project inside the repository.node-version
- Optional: the specific version of Node that should be used to build your site. Defaults to16
.package-manager
- Optional: the Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. Accepted values:npm
,yarn
,pnpm
, andbun
.pnpm-version
- Optional: Ifpackage-manager
is set topnpm
, use this specific version. Defaults to7.x.x
.resolve-dep-from-path
- Optional: If the dependency file should be resolved from the root location of your Astro project. Defaults totrue
.
Create a file at .github/workflows/deploy.yml
with the following content.
name: Deploy to GitHub Pages
on:
# Trigger the workflow every time you push to the `main` branch
# Using a different branch name? Replace `main` with your branch’s name
push:
branches: [main]
# Allows you to run this workflow manually from the Actions tab on GitHub.
workflow_dispatch:
# Allow this job to clone the repo and create a page deployment
permissions:
contents: read
pages: write
id-token: write
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout your repository using git
uses: actions/checkout@v3
- name: Install, build, and upload your site output
uses: withastro/action@v0
# with:
# path: . # The root location of your Astro project inside the repository. (optional)
# node-version: 16 # The specific version of Node that should be used to build your site. Defaults to 16. (optional)
# package-manager: pnpm # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
# pnpm-version: 8.x.x # If `package-manager` is set to `pnpm`, use this specific version. Defaults to `7.x.x`. (optional)
# resolve-dep-from-path: false # If the dependency file should be resolved from the root location of your Astro project. Defaults to `true`. (optional)
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v1