This custom action will help you to deploy your PageBuilder bundles to Arc XP using your Arc XP environment.

NOTE: This action requires that you have an active Arc XP account. If you do not have an Arc XP account, or you have any questions, please contact your Arc XP representative.

This action deploys a PageBuilder Bundle to Arc XP using your Arc XP credentials. It will deploy the project to the Arc XP instance that matches the api-hostname input. If the project has not been deployed before, it will create an initial deployment. If the project has been deployed before, it will create a new deployment and delete the oldest deployment if the number of deployments exceeds the minimum-running-versions input.

You must have a PageBuilder Bundle that has been built and is ready to be deployed. You must also have an Arc XP organization ID, API key, and API hostname.

This action requires that you have an Arc XP account. It will use your Arc XP API key to authenticate with Arc XP. The API key is stored as a secret in your GitHub repository. The API key is used to authenticate with Arc XP and is not shared with anyone else.

      - name: Perform the deploy
        if: ${{ success() }}
        uses: arcxp/deploy-action@v1
        with:
          org-id: your-org-here
          api-key: "${{ secrets.YOUR_DEPLOYER_TOKEN_HERE }}"
          api-hostname: api.sandbox.your-org-here.arcpublishing.com
          bundle-prefix: action-demo-1

Required The Arc XP organization ID.

Required Your Arc XP API key.

Required The host name for your Arc XP instances.

This is the version of PageBuilder you wish to deploy with. Default is latest.

The prefix for the bundle name, which is used to identify the bundle in the Arc XP UI.

The number of times to retry the deployment if there's a recoverable error. Default 10.

The number of seconds to wait between retries. Default 5.

The minimum number of versions to keep in a "deployed" state at any given time. The maximum is 10, the minimum is 1. Default 7.

This is an option that would allow you to skip deployment. Default true.

This is an option that would allow you to skip promoting a version. If deploy is false, and this is true, the workflow will fail. Default true.

Here's a complete example from a GitHub Action workflow file. This example first builds and zips the PageBuilder Bundle, and then uses this custom action to deploy to the "Sandbox" environment in the your-org-here instance of Arc XP.

---
name: Deploy a PageBuilder Bundle with Custom Action

on:
  push:
    # Adjust this list of branches if you want to use this action
    # for PRs and pushes.
    branches:
      - branch-name-here
  # This action lets you run this Action manually.
  workflow_dispatch:

jobs:
  new-deployer:
    runs-on: ubuntu-latest

    steps:
      - name: Configure path
        if: ${{ success() }}
        run: |
          echo "./node_modules/.bin" >> $GITHUB_PATH

      - name: Checkout the code
        if: ${{ success() }}
        uses: actions/checkout@v4

      # This configures NodeJS for our purposes.
      - name: Set up Node
        if: ${{ success() }}
        uses: actions/setup-node@v4
        with:
          #### IF YOU NEED TO CHANGE YOUR NODE VERSION, JUST CHANGE THIS NUMBER
          node-version: 20
          cache: npm

      # Installs NodeJS dependencies.
      - name: Install dependencies
        if: ${{ success() }}
        run: |
          npm install

      # Build the code.
      - name: Build the PageBuilder Bundle
        if: ${{ success() }}
        run: |
          fusion build
          fusion zip --rename fusion-bundle

      - name: Perform the deploy
        if: ${{ success() }}
        uses: arcxp/deploy-action@v1
        with:
          org-id: your-org-here
          api-key: "${{ secrets.SANDBOX_DEPLOYER_TOKEN }}"
          api-hostname: api.sandbox.your-org-here.arcpublishing.com
          bundle-prefix: bundle-prefix-here

This project is licensed under the MIT License - see the LICENSE.md file for details.