This GitHub Action deploys your frontend apps to Contentful App Hosting.
Contentful provides content infrastructure for digital teams to power content in websites, apps, and devices. Unlike a CMS, Contentful was built to integrate with the modern software stack. It offers a central hub for structured content, powerful management and delivery APIs, and a customisable web app that enables developers and content creators to ship digital products faster.
Contentful is a hosted service, with a free plan for small projects. It is available in 14 languages and has over 100,000 users worldwide.
Apps are packages that simplify customization and integration by modifying your Contentful space. An app can help adapt Contentful to individual business processes and integrate with other services.
Check out Contentful App Framework to learn more about Contentful Apps.
If your App is hosted on Contentful App Hosting, you can use this GitHub Action to automatically deploy your App after pushing your code. This saves a lot of time and manual uploading.
To use this GitHub Action, you need to create a GitHub workflow file in your repository. The workflow file should be placed in the .github/workflows directory in your repository.
The contents of the workflow file should be as follows:
on: [push]
jobs:
deploy_job:
runs-on: ubuntu-latest
name: Deploy app to Contentful
if: contains(github.ref, 'main') || contains(github.ref, 'master')
steps:
- uses: actions/checkout@v3
- name: Use Node.js 16.x
uses: actions/setup-node@v3
with:
node-version: 16.x
- run: npm ci
- run: npm run build
- uses: contentful/actions-app-deploy@v1
with:
organization-id: ${{ secrets.ORGANIZATION_ID }}
app-definition-id: ${{ secrets.APP_DEFINITION_ID }}
access-token: ${{ secrets.ACCESS_TOKEN }}
folder: buildorganization-id (required): The id of the organization.app-definition-id (required): The id of the app definition.access-token (required): A personal access token for the Content Management API. Should be stored as a secret in your GitHub repository (Settings -> Secrets -> Actions).folder (required): The folder which is deployed to Contentful App Hosting. Usually, this is the build folder.comment : A comment which will be associated with the created AppBundle. Can be used to differentiate bundles.allow-tracking (optional): Flag that allows us to track the usage of the GitHub Action. Accepted values can be either true or false, default value will be true.After you have created the workflow file and added the secrets, you can push your code to the repository. The GitHub Action will automatically run and deploy your App to Contentful App Hosting.
You can see the progress of the workflow in the Actions tab of your repository.
Where to find the organization ID
Log into Contentful. Click the Organization name in the top left corner, then "Organization settings". Click the "Subscription" tab. The ID is listed beneath the organization name.
Where to find the app definition ID
Log into Contentful.
From your space, go to the Apps tab and click Custom apps.
Click Manage app definitions and you will see an overview of your custom apps, with the ID printed in the ID column.
Where to find or create a personal access token
You can read more about access tokens here
npm run build was run and the latest build output was committed.git tag -a v1.x.x -m "v1.x.x"git tag --delete v1
git tag -a v1.x.x -m "v1.x.x"git push origin v1.x.x
git push origin v1 --force