{"meta":{"title":"Comece a usar o Actions Runner Controller","intro":"Neste tutorial, você experimentará as noções básicas do Actions Runner Controller.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/tutorials","title":"Tutoriais"},{"href":"/pt/actions/tutorials/use-actions-runner-controller","title":"Controlador de Ações Runner"},{"href":"/pt/actions/tutorials/use-actions-runner-controller/get-started","title":"Introdução"}],"documentType":"article"},"body":"# Comece a usar o Actions Runner Controller\n\nNeste tutorial, você experimentará as noções básicas do Actions Runner Controller.\n\n## Pré-requisitos\n\nPara usar o ARC, verifique se você tem os itens a seguir.\n\n* Um cluster do Kubernetes\n  * Para um ambiente de nuvem gerenciado, você pode usar o AKS. Para obter mais informações, consulte [Azure Kubernetes Service](https://azure.microsoft.com/en-us/products/kubernetes-service) na documentação do Azure.\n  * Para uma configuração local, você pode usar o minikube ou o kind. Para obter mais informações, confira [minikube start](https://minikube.sigs.k8s.io/docs/start/) na documentação do minikube e [kind](https://kind.sigs.k8s.io/) na documentação do kind.\n\n* Helm 3\n  * Para obter mais informações, confira [Como instalar o Helm](https://helm.sh/docs/intro/install/) na documentação do Helm.\n\n* Embora não seja necessário implantar o ARC, é recomendável garantir que você tenha uma maneira de coletar e reter logs do controlador, dos ouvintes e dos executores efêmeros antes de implantar o ARC em fluxos de trabalho da produção.\n\n## Como instalar o Actions Runner Controller\n\n1. Para instalar o operador e as CRDs (definições de recursos personalizados) no cluster, execute as etapas a seguir.\n\n   1. No gráfico do Helm, atualize o valor `NAMESPACE` para o local em que deseja criar os pods do operador. Esse namespace precisa permitir o acesso ao servidor de API do Kubernetes.\n   2. Instale o gráfico do Helm.\n\n   O exemplo a seguir instala a última versão do gráfico. Para instalar uma versão específica, transmita o argumento `--version` com a versão do gráfico que deseja instalar. Você pode encontrar a lista de versões no Registro de Contêiner [GitHub](https://github.com/actions/actions-runner-controller/pkgs/container/actions-runner-controller-charts%2Fgha-runner-scale-set-controller).\n\n   ```bash copy\n   NAMESPACE=\"arc-systems\"\n   helm install arc \\\n       --namespace \"${NAMESPACE}\" \\\n       --create-namespace \\\n       oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set-controller\n   ```\n\n   Para ver mais opções de configuração do Helm, confira [`values.yaml`](https://github.com/actions/actions-runner-controller/blob/master/charts/gha-runner-scale-set-controller/values.yaml) na documentação do ARC.\n\n2. Para permitir que o ARC se autentique no GitHub, gere um personal access token (classic). Para obter mais informações, consulte [Autenticando o ARC na API de GitHub](/pt/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api#deploying-using-personal-access-token-classic-authentication).\n\n## Como configurar um conjunto de dimensionamento de executores\n\n1. Para configurar o conjunto de dimensionamento de executores, execute o comando a seguir no terminal usando valores da configuração do ARC.\n\n   Ao executar o comando, tenha em mente as instruções a seguir.\n\n   * Atualize o valor `INSTALLATION_NAME` com cuidado. Você usará o nome da instalação como o valor de `runs-on` nos seus fluxos de trabalho. Para obter mais informações, consulte [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idruns-on).\n\n   * Atualize o valor `NAMESPACE` para o local em que deseja criar os pods do executor.\n\n   * Defina `GITHUB_CONFIG_URL` como a URL do repositório, da organização ou da empresa. Essa é a entidade à qual os corredores pertencerão.\n\n   * Defina `GITHUB_PAT` para um GitHub personal access token com os escopos `repo` e `admin:org` para executores de repositório e organização.\n\n   * Este exemplo de comando instala a última versão do gráfico do Helm. Para instalar uma versão específica, transmita o argumento `--version` com a versão do gráfico que deseja instalar. Você pode encontrar a lista de versões no Registro de Contêiner [GitHub](https://github.com/actions/actions-runner-controller/pkgs/container/actions-runner-controller-charts%2Fgha-runner-scale-set).\n\n     > \\[!NOTE]\n     >\n     > * Como uma melhor prática de segurança, crie os pods do executor em um namespace diferente do namespace que contém os pods do operador.\n     > * Como uma melhor prática de segurança, crie segredos do Kubernetes e passe as referências secretas. Passar seus segredos em texto sem formatação por meio da CLI pode representar um risco à segurança. Para obter mais informações, confira [Como implantar conjuntos de dimensionamento de executores com o Actions Runner Controller](/pt/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller).\n\n     ```bash copy\n     INSTALLATION_NAME=\"arc-runner-set\"\n     NAMESPACE=\"arc-runners\"\n     GITHUB_CONFIG_URL=\"https://github.com/<your_enterprise/org/repo>\"\n     GITHUB_PAT=\"<PAT>\"\n     helm install \"${INSTALLATION_NAME}\" \\\n         --namespace \"${NAMESPACE}\" \\\n         --create-namespace \\\n         --set githubConfigUrl=\"${GITHUB_CONFIG_URL}\" \\\n         --set githubConfigSecret.github_token=\"${GITHUB_PAT}\" \\\n         oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set\n     ```\n\n     Para ver mais opções de configuração do Helm, confira [`values.yaml`](https://github.com/actions/actions-runner-controller/blob/master/charts/gha-runner-scale-set/values.yaml) na documentação do ARC.\n\n2. No terminal, execute o comando a seguir para verificar sua instalação.\n\n   ```bash copy\n   helm list -A\n   ```\n\n   Você deverá ver um resultado semelhante ao seguinte.\n\n   ```bash\n   NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                                       APP VERSION\n   arc             arc-systems     1               2023-04-12 11:45:59.152090536 +0000 UTC deployed        gha-runner-scale-set-controller-0.4.0       0.4.0\n   arc-runner-set  arc-runners     1               2023-04-12 11:46:13.451041354 +0000 UTC deployed        gha-runner-scale-set-0.4.0                  0.4.0\n   ```\n\n3. Para verificar o pod do gerenciador, execute o comando a seguir no terminal.\n\n   ```bash copy\n   kubectl get pods -n arc-systems\n   ```\n\n   Se tudo tiver sido instalado com sucesso, a status dos pods será exibido como **Em execução**.\n\n   ```bash\n   NAME                                                   READY   STATUS    RESTARTS   AGE\n   arc-gha-runner-scale-set-controller-594cdc976f-m7cjs   1/1     Running   0          64s\n   arc-runner-set-754b578d-listener                       1/1     Running   0          12s\n   ```\n\nSe a instalação não tiver sido bem-sucedida, confira [Solução de problemas dos erros do Actions Runner Controller](/pt/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors) para obter informações sobre solução de problemas.\n\n## Como usar conjuntos de dimensionamento de executores\n\nAgora você criará e executará um fluxo de trabalho de teste simples que usa os executores do conjunto de dimensionamento de executores.\n\n1. Em um repositório, crie um fluxo de trabalho semelhante ao exemplo a seguir. O valor `runs-on` deve corresponder ao nome de instalação do Helm usado quando você instalou o conjunto de executores de dimensionamento automático.\n\n   Para obter mais informações sobre como adicionar fluxos de trabalho a um repositório, confira [Guia Rápido do GitHub Actions](/pt/actions/quickstart#creating-your-first-workflow).\n\n   ```yaml copy\n   name: Actions Runner Controller Demo\n   on:\n     workflow_dispatch:\n\n   jobs:\n     Explore-GitHub-Actions:\n       # You need to use the INSTALLATION_NAME from the previous step\n       runs-on: arc-runner-set\n       steps:\n       - run: echo \"🎉 This job uses runner scale set runners!\"\n   ```\n\n2. Depois de adicionar o fluxo de trabalho ao repositório, dispare manualmente o fluxo de trabalho. Para obter mais informações, consulte [Executar um fluxo de trabalho manualmente](/pt/actions/managing-workflow-runs/manually-running-a-workflow).\n\n3. Para ver os pods do executor que estão sendo criados enquanto o fluxo de trabalho está em execução, execute o comando a seguir no terminal.\n\n   ```bash copy\n   kubectl get pods -n arc-runners -w\n   ```\n\n   Um resultado bem-sucedido será semelhante ao seguinte.\n\n   ```bash\n   NAMESPACE     NAME                                                  READY   STATUS    RESTARTS      AGE\n   arc-runners   arc-runner-set-rmrgw-runner-p9p5n                     1/1     Running   0             21s\n   ```\n\n## Próximas Etapas \n\nO Actions Runner Controller pode ajudar você a gerenciar com eficiência seus executores do GitHub Actions. Pronto para começar? Confira alguns recursos úteis para dar seus próximos passos com o ARC:\n\n* Para obter informações detalhadas sobre autenticação, confira [Autenticando o ARC na API de GitHub](/pt/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api).\n* Para obter ajuda no uso de executores do ARC nos fluxos de trabalho, confira [Usar executores do Controlador do Executor de Ações em um fluxo de trabalho](/pt/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow).\n* Para obter informações sobre a implantação, consulte [Como implantar conjuntos de dimensionamento de executores com o Actions Runner Controller](/pt/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller).\n\n## Aviso legal\n\nPartes foram adaptadas do <https://github.com/actions/actions-runner-controller/> de acordo com a licença Apache-2.0:\n\n```text\nCopyright 2019 Moto Ishizawa\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```"}