Utilisation des exécuteurs de l'Actions Runner Controller dans un flux de travail

Utilisez Actions Runner Controller exécuteurs dans un fichier de flux de travail.

Dans cet article

Utilisation des exécuteurs ARC dans un fichier de workflow

Pour affecter des travaux à exécuter sur un groupe identique d’exécuteurs, vous pouvez spécifier le nom du groupe identique en tant que valeur de la clé runs-on dans votre fichier de flux de travail GitHub Actions.

Par exemple, la configuration suivante pour un ensemble de mise à l’échelle des exécuteurs a la valeur INSTALLATION_NAME définie sur 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

Pour utiliser cette configuration dans un flux de travail, définissez la valeur de la clé runs-on dans votre flux de travail sur arc-runner-set, comme dans l’exemple suivant.

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

Utilisation des noms de groupes identiques d’exécuteurs

Les noms des ensembles de dimensions des agents sont uniques au sein du groupe d'agents auquel ils appartiennent. Pour déployer plusieurs ensembles d'échelles d'exécuteurs portant le même nom, ils doivent appartenir à des groupes d'exécuteurs différents. Pour plus d’informations sur la spécification des noms de groupes identiques d’exécuteurs, consultez Déploiement de groupes identiques d’exécuteurs avec Actions Runner Controller.

Vous pouvez utiliser le nom d’installation de l'ensemble de mise à l'échelle de l'exécuteur ou définir la valeur du champ runnerScaleSetName dans votre fichier values.yaml, comme cible runs-on. Vous pouvez également affecter plusieurs étiquettes à un groupe identique pour permettre un routage de travaux plus flexible. Pour configurer des étiquettes pour un ensemble d'exécuteurs, définissez la valeur runnerScaleSetLabels dans votre fichier values.yaml. Pour plus d’informations, consultez « Déploiement de groupes identiques d’exécuteurs avec Actions Runner Controller ».

Utilisation d’étiquettes pour cibler des ensembles d'échelles de coureurs

Vous pouvez également affecter plusieurs étiquettes à un groupe identique d’exécuteurs et les utiliser pour cibler des exécuteurs dans votre flux de travail. Pour configurer des étiquettes pour un ensemble d'échelles d'exécuteurs, définissez les runnerScaleSetLabels valeurs dans votre fichier values.yaml.

runnerScaleSetLabels:
  - linux
  - gpu
  - private-network

Pour cibler un ensemble évolutif d’exécuteurs avec des étiquettes spécifiques, spécifiez les étiquettes sous forme de tableau dans la clé runs-on de votre workflow.

jobs:
  job_name:
    runs-on: [linux, gpu, private-network]

Certaines parties ont été adaptées à partir de https://github.com/actions/actions-runner-controller/ sous la licence 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.