actions.mdx

sidebar_position	title	description
2	GitHub Actions	Leverage GitHub actions to manage your certificate lifecycles.

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

A GitHub action has been created to allow simple integation into your existing pipelines. All actions that can be performed via the az-acme CLI can also be run using the GitHub Action.

:::tip

It is recommended to use private agents if possible so you can restirct the Azure Key Vault to be accessible via Private Endpoints.

:::

A complete example of using the GitHub Action is shown below, including using the azure/login@v1 action for authentication.

steps:
- uses: az-acme/setup-cli-actionh@v1
  with:
    version: 0.2

- uses: azure/login@v1
  with:
    creds: ${{ secrets.AZURE_CREDENTIALS }}

- name: Register with Staging
  run: |
    az-acme register \
      --server https://acme-staging-v02.api.letsencrypt.org/directory \
      --key-vault-uri https://kvazacmedev.vault.azure.net/ \
      --account-secret letsencrypt-stg-registration \
      --email demo@azacme.dev \
      --agree-tos