Uso de ejecutores de Actions Runner Controller en un flujo de trabajo

Use Actions Runner Controller runners in a workflow file.

En este artículo

Usar ejecutores de ARC en un archivo de flujo de trabajo

Para asignar trabajos de modo que se ejecuten en un conjunto de escalado de ejecutor, puedes especificar el nombre del conjunto de escalado como valor de la clave runs-on en el archivo de flujo de trabajo de GitHub Actions.

Por ejemplo, la configuración siguiente para un conjunto de escalado de ejecutor tiene el valor INSTALLATION_NAME establecido en 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 esta configuración en un flujo de trabajo, establece el valor de la clave runs-on del flujo de trabajo en arc-runner-set, como en el ejemplo siguiente.

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

Uso de nombres de conjuntos de escalado del ejecutor

Los nombres de conjuntos de escalado de ejecutor son únicos dentro del grupo de ejecutores al que pertenecen. Para implementar varios conjuntos de escalado de ejecutor con el mismo nombre, deben pertenecer a grupos de ejecutores diferentes. Para obtener más información sobre cómo especificar nombres de conjuntos de escalado de ejecutor, consulta Implementación de conjuntos de escalado de ejecutor con Actions Runner Controller.

Puede usar el nombre de la instalación del conjunto de escalado de corredores, o definir el valor del campo runnerScaleSetName en su archivo values.yaml, como su destino runs-on. También puede asignar varias etiquetas a un conjunto de escalado para habilitar el enrutamiento de trabajos más flexible. Para configurar etiquetas para un conjunto de escalado de ejecutores, establezca el valor runnerScaleSetLabels en el archivo values.yaml. Para obtener más información, consulta Implementación de conjuntos de escalado de ejecutor con Actions Runner Controller.

Uso de etiquetas para conjuntos de escalado de ejecutores de destino

También puede asignar varias etiquetas a un conjunto de escalado de ejecutor y usarlas para los ejecutores de destino en el flujo de trabajo. Para configurar etiquetas para un conjunto de escalado de ejecutor, establezca los runnerScaleSetLabels valores del values.yaml archivo.

runnerScaleSetLabels:
  - linux
  - gpu
  - private-network

Para establecer como destino un conjunto de escalado de ejecutor con etiquetas específicas, especifique las etiquetas como una matriz en la runs-on clave del flujo de trabajo.

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

Algunas partes se han adaptado a partir de https://github.com/actions/actions-runner-controller/ con licencia 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.