Deploying with GitHub Actions

Learn how to set up automated deployments to seenode using GitHub Actions, including configuring secrets, creating workflows, and managing deployments.

This guide explains how to set up a GitHub Action that automatically triggers a new deployment on seenode whenever a commit is pushed to a specified branch.

Prerequisites

A GitHub repository containing your application.
An existing seenode application linked to that repository.
An API token for the seenode API.
Permissions to create GitHub Actions and manage repository secrets.

Getting an API Token

Learn how to generate and manage API tokens for authenticating with the seenode API.

Add Secrets to GitHub

To keep your credentials secure, store them as encrypted secrets in your GitHub repository.
1. In your GitHub repository, go to Settings > Secrets and variables > Actions.
2. Click New repository secret to add the following secrets:
  - SEENODE_APPLICATION_ID: The ID of your seenode application.
  - SEENODE_API_TOKEN: Your seenode API token.
Tip

You can find your application ID in the URL of your application’s dashboard on seenode: https://seenode.com/dashboard/applications?applicationId=969217 → 969217

Create the GitHub Actions Workflow

Create a workflow file in your repository to define the deployment job.

Create a .github/workflows/ directory in your repository if it doesn’t already exist.
Inside this directory, create a new file named deploy.yml.
Add the following content to the deploy.yml file:

1
name: Deploy to **seenode**
2

3
on:
4
  push:
5
    branches:
6
      - main # Trigger the workflow on pushes to the main branch
7

8
jobs:
9
  deploy:
10
    runs-on: ubuntu-latest
11
    steps:
12
      - name: Trigger **seenode** Deployment
13
        run: |
14
          curl -X POST \
15
            -H "Authorization: Bearer ${{ secrets.SEENODE_API_TOKEN }}" \
16
            -H "Content-Type: application/json" \
17
            -d '{"gitCommitSha": "${{ github.sha }}"}' \
18
            "https://api.seenode.com/v1/applications/${{ secrets.SEENODE_APPLICATION_ID }}/deployments"

This workflow will be triggered on every push to the main branch. It sends a POST request to the seenode API to trigger a new deployment using the latest commit.

Commit and Push

Commit the new workflow file to your repository to activate it.

git add .github/workflows/deploy.yml
git commit -m "ci: Add GitHub Action for **seenode** deployment"
git push

Verify the Deployment

Once you’ve pushed the workflow, you can verify that it’s working correctly.
1. In your GitHub repository, go to the Actions tab. You should see the workflow running.
2. In the seenode Dashboard, navigate to your application’s Deployments tab. You should see a new deployment in progress.

Troubleshooting

Workflow Not Triggering: Ensure you are pushing to the correct branch specified in the on.push.branches section of your workflow file.
Authentication Error: Double-check that your SEENODE_API_TOKEN and SEENODE_APPLICATION_ID secrets are correct and have no extra spaces or characters.
Invalid Request: Verify the API endpoint in the curl command. Ensure the application ID is correct.