{"meta":{"title":"Implantando no Azure Kubernetes Service","intro":"Saiba como implantar um projeto no serviço Azure Kubernetes (AKS) como parte de um fluxo de trabalho de implantação contínua (CD).","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/how-tos","title":"Instruções"},{"href":"/pt/actions/how-tos/deploy","title":"Implantar"},{"href":"/pt/actions/how-tos/deploy/deploy-to-third-party-platforms","title":"Implantar em plataformas de terceiros"},{"href":"/pt/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-kubernetes-service","title":"Serviço de Kubernetes do Azure"}],"documentType":"article"},"body":"# Implantando no Azure Kubernetes Service\n\nSaiba como implantar um projeto no serviço Azure Kubernetes (AKS) como parte de um fluxo de trabalho de implantação contínua (CD).\n\n## Pré-requisitos\n\nAntes de criar seu fluxo de trabalho de GitHub Actions, primeiro você precisa concluir as etapas de configuração a seguir:\n\n1. Crie um cluster AKS de destino e um ACR (Azure Container Registry). Para obter mais informações, consulte [Quickstart: Implantar um cluster aks usando o portal Azure - Azure Kubernetes Service](https://docs.microsoft.com/azure/aks/kubernetes-walkthrough-portal) e [Quickstart - Criar registro no portal - Azure Container Registry](https://docs.microsoft.com/azure/container-registry/container-registry-get-started-portal) na documentação do Azure.\n\n1. Crie um segredo chamado `AZURE_CREDENTIALS` para armazenar suas credenciais de Azure. Para obter mais informações sobre como encontrar essas informações e estruturar o segredo, consulte [a documentação da ação `Azure/login`](https://github.com/Azure/login#configure-a-service-principal-with-a-secret).\n\n## Criar o fluxo de trabalho\n\nDepois de preencher os pré-requisitos, você pode prosseguir com a criação do fluxo de trabalho.\n\nO fluxo de trabalho de exemplo a seguir demonstra como criar e implantar um projeto para Azure Kubernetes Service quando o código é enviado por push para o repositório.\n\nAbaixo da chave `env` de fluxo de trabalho, altere os seguintes valores:\n* `AZURE_CONTAINER_REGISTRY` para o nome do registro de contêiner\n* `PROJECT_NAME` para o nome do projeto\n* `RESOURCE_GROUP` para o grupo de recursos que contém o cluster do AKS\n* `CLUSTER_NAME` para o nome do cluster do AKS\n\nEsse fluxo de trabalho usa o mecanismo de renderização `helm` para a ação [`azure/k8s-bake`](https://github.com/Azure/k8s-bake). Se você usar o mecanismo de renderização `helm`, altere o valor de `CHART_PATH` para o caminho para o arquivo do Helm. Altere `CHART_OVERRIDE_PATH` para uma matriz de caminhos de arquivo de substituição. Se você usar outro mecanismo de renderização, atualize os parâmetros de entrada enviados para a ação `azure/k8s-bake`.\n\n```yaml copy\n# Esse fluxo de trabalho usa ações que não são certificadas pelo GitHub.\n# São fornecidas por terceiros e regidas por\n# termos de serviço, política de privacidade e suporte separados\n# online.\n\n# O GitHub recomenda fixar ações em um SHA de commit.\n# Para obter uma versão mais recente, você precisará atualizar o SHA.\n# Você também pode fazer referência a uma marca ou branch, mas a ação pode ser alterada sem aviso.\n\nname: Build and deploy to Azure Kubernetes Service\n\nenv:\n  AZURE_CONTAINER_REGISTRY: MY_REGISTRY_NAME # set this to the name of your container registry\n  PROJECT_NAME: MY_PROJECT_NAME              # set this to your project's name\n  RESOURCE_GROUP: MY_RESOURCE_GROUP          # set this to the resource group containing your AKS cluster\n  CLUSTER_NAME: MY_CLUSTER_NAME              # set this to the name of your AKS cluster\n  REGISTRY_URL: MY_REGISTRY_URL              # set this to the URL of your registry\n  # If you bake using helm:\n  CHART_PATH: MY_HELM_FILE                   # set this to the path to your helm file\n  CHART_OVERRIDE_PATH: MY_OVERRIDE_FILES     # set this to an array of override file paths\n\non: [push]\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n    - uses: actions/checkout@v6\n\n    - name: Azure Login\n      uses: azure/login@14a755a4e2fd6dff25794233def4f2cf3f866955\n      with:\n        creds: ${{ secrets.AZURE_CREDENTIALS }}\n\n    - name: Build image on ACR\n      uses: azure/CLI@61bb69d64d613b52663984bf12d6bac8fd7b3cc8\n      with:\n        azcliversion: 2.29.1\n        inlineScript: |\n          az configure --defaults acr=${{ env.AZURE_CONTAINER_REGISTRY }}\n          az acr build -t -t ${{ env.REGISTRY_URL }}/${{ env.PROJECT_NAME }}:${{ github.sha }}\n\n    - name: Gets K8s context\n      uses: azure/aks-set-context@94ccc775c1997a3fcfbfbce3c459fec87e0ab188\n      with:\n          creds: ${{ secrets.AZURE_CREDENTIALS }}\n          resource-group: ${{ env.RESOURCE_GROUP }}\n          cluster-name: ${{ env.CLUSTER_NAME }}\n      id: login\n\n    - name: Configure deployment\n      uses: azure/k8s-bake@61041e8c2f75c1f01186c8f05fb8b24e1fc507d8\n      with:\n        renderEngine: 'helm'\n        helmChart: ${{ env.CHART_PATH }}\n        overrideFiles: ${{ env.CHART_OVERRIDE_PATH }}\n        overrides: |\n          replicas:2\n        helm-version: 'latest'\n      id: bake\n\n    - name: Deploys application\n      uses: Azure/k8s-deploy@dd4bbd13a5abd2fc9ca8bdcb8aee152bb718fa78\n      with:\n        manifests: ${{ steps.bake.outputs.manifestsBundle }}\n        images: |\n          ${{ env.AZURE_CONTAINER_REGISTRY }}.azurecr.io/${{ env.PROJECT_NAME }}:${{ github.sha }}\n        imagepullsecrets: |\n          ${{ env.PROJECT_NAME }}\n```\n\n## Leitura adicional\n\n* Para o modelo de fluxo de trabalho original, confira [`azure-kubernetes-service.yml`](https://github.com/actions/starter-workflows/blob/main/deployments/azure-kubernetes-service.yml) no repositório `starter-workflows` do GitHub Actions.\n* As ações usadas neste fluxo de trabalho são as ações oficiais do Azure [`Azure/login`](https://github.com/Azure/login), [`Azure/aks-set-context`](https://github.com/Azure/aks-set-context), [`Azure/CLI`](https://github.com/Azure/CLI), [`Azure/k8s-bake`](https://github.com/Azure/k8s-bake) e [`Azure/k8s-deploy`](https://github.com/Azure/k8s-deploy).\n* Para obter mais exemplos de fluxos de trabalho GitHub Action que são implantados em Azure, consulte o repositório [actions-workflow-samples](https://github.com/Azure/actions-workflow-samples)."}