Skip to main content

Utilisation d’exécuteurs Actions Runner Controller dans un flux de travail

Vous pouvez utiliser des exécuteurs Actions Runner Controller dans un fichier de flux de travail.

Mentions légales

À propos de l’utilisation d’exécuteurs ARC dans un fichier de flux de travail

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 groupe identique d’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 de groupes identiques d’exécuteurs sont uniques au sein du groupe d’exécuteurs auquel ils appartiennent. Si vous voulez déployer plusieurs groupes identiques d’exécuteurs portant le même nom, ils doivent appartenir à différents groupes d’exécuteurs. 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 ne pouvez pas utiliser d’étiquettes supplémentaires pour cibler les exécuteurs créés par ARC. Vous pouvez uniquement utiliser le nom d’installation du groupe identique d’exécuteurs que vous avez spécifié pendant l’installation ou en définissant la valeur du champ runnerScaleSetName dans votre fichier values.yaml. Celles-ci sont utilisées comme « étiquette unique » à utiliser comme cible runs-on. Pour plus d’informations, consultez « Déploiement de groupes identiques d’exécuteurs avec Actions Runner Controller ».

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.