Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
arrow-up-circle

GitHub Action

Update Coder Template

v3.0.0

Update Coder Template

arrow-up-circle

Update Coder Template

An action to deploy changes to your coder template automatically

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Update Coder Template

uses: matifali/[email protected]

Learn more about this action in matifali/update-coder-template

Choose a version

Update Coder Template

Update coder templates automatically

Usage

  1. Create a GitHub secret named CODER_SESSION_TOKEN with your coder session token You can generate a long lived session token by running the following command in your browser console while logged into Coder with a Template Admin or Owner role.

      coder token create --lifetime 8760h --name "GitHub Actions"
  2. Create a .github/workflows/push-coder-template.yaml file and use one of the examples below.

Inputs

Name Description Default
url Required The url of coder deployment (e.g. https://dev.coder.com). -
coder_session_token Required The session token of coder. -
id Required The id of template. -
dir Required The directory of the template that contains main.tf file -
name New version name for the template. Autogenerated name by Coder
activate Activate the new template version. true
create Creates a new template if it does not exist true
message Update message (similar to commit messages) -
dry_run Dry run mode. false

Examples

  1. Update a Coder template with the latest commit hash as the version name, commit message as the update message and mark this as active.

    name: Update Coder Template
    
    on:
      push:
        branches:
          - main
    
    jobs:
        update:
            runs-on: ubuntu-latest
            steps:
            - name: Checkout
              uses: actions/checkout@v3
            - name: Get latest commit hash
              id: latest_commit
              run: echo "hash=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
            - name: Get commit title
               id: commit_title
               run: echo "title=$(git log -1 --pretty=%B)" >> $GITHUB_OUTPUT
    
    
            - name: Update Coder Template
                uses: matifali/update-coder-template@v3
                with:
                    id: "my-template"
                    dir: "my-template"
                    url: "https://coder.example.com"
                    name: "${{ steps.latest_commit.outputs.hash }}"
                    message: "${{ steps.commit_title.outputs.title }}"
                    coder_session_token: ${{ secrets.CODER_SESSION_TOKEN }}
  2. Update a Coder template with a random version name without activating.

    name: Update Coder Template
    
    on:
      push:
        branches:
          - main
    
    jobs:
        update:
            runs-on: ubuntu-latest
            steps:
            - name: Checkout
              uses: actions/checkout@v3
    
            - name: Update Coder Template
                uses: matifali/update-coder-template@v3
                with:
                    id: "my-template"
                    dir: "my-template"
                    url: "https://coder.example.com"
                    activate: "false"
                    coder_session_token: ${{ secrets.CODER_SESSION_TOKEN }}