Skip to main content

Usar executores do Controlador do Executor de Ações em um fluxo de trabalho

Você pode usar executores do Actions Runner Controller em um arquivo de fluxo de trabalho.

Aviso legal

Sobre como usar executores ARC em um arquivo de fluxo de trabalho

Para atribuir trabalhos a serem executados em um conjunto de dimensionamento de executores, você poderá especificar o nome do conjunto de dimensionamento como o valor da chave runs-on no arquivo de fluxo de trabalho do GitHub Actions.

Por exemplo, a configuração a seguir para um conjunto de dimensionamento de executores tem o valor INSTALLATION_NAME definido como arc-runner-set.

# Using a Personal Access Token (PAT)
INSTALLATION_NAME="arc-runner-set"
NAMESPACE="arc-runners"
GITHUB_CONFIG_URL="https://github.com/<your_enterprise/org/repo>"
GITHUB_PAT="<PAT>"
helm install "${INSTALLATION_NAME}" \
    --namespace "${NAMESPACE}" \
    --create-namespace \
    --set githubConfigUrl="${GITHUB_CONFIG_URL}" \
    --set githubConfigSecret.github_token="${GITHUB_PAT}" \
    oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set

Para usar essa configuração em um fluxo de trabalho, defina o valor da chave runs-on em seu fluxo de trabalho como arc-runner-set, semelhante ao exemplo a seguir.

jobs:
  job_name:
    runs-on: arc-runner-set

Usar nomes do conjunto de dimensionamento de executores

Os nomes do conjunto de dimensionamento do executor são exclusivos dentro do grupo de executores ao qual pertencem. Para implantar vários conjuntos de dimensionamento de executores com o mesmo nome, eles deverão pertencer a diferentes grupos de executores. Para obter mais informações sobre como especificar nomes do conjunto de dimensionamento de executores, confira Como implantar conjuntos de dimensionamento de executores com o Actions Runner Controller.

Você não pode usar rótulos adicionais para direcionar executores criados pelo ARC. Você só pode usar o nome da instalação do conjunto de dimensionamento do executor especificado durante a instalação ou definindo o valor do campo runnerScaleSetName em seu arquivo values.yaml. Estes são usados como o "rótulo único" para usar como seu destino runs-on. Para saber mais, confira Como implantar conjuntos de dimensionamento de executores com o Actions Runner Controller.

Partes foram adaptadas do https://github.com/actions/actions-runner-controller/ de acordo com a licença Apache-2.0:

Copyright 2019 Moto Ishizawa

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.