{"meta":{"title":"Deploying to Azure Kubernetes Service","intro":"Узнайте, как развернуть проект в Azure Kubernetes Service (AKS) в рамках рабочего процесса непрерывного развертывания (CD).","product":"GitHub Actions","breadcrumbs":[{"href":"/ru/actions","title":"GitHub Actions"},{"href":"/ru/actions/how-tos","title":"Инструкции"},{"href":"/ru/actions/how-tos/deploy","title":"Развернуть"},{"href":"/ru/actions/how-tos/deploy/deploy-to-third-party-platforms","title":"Развертывание на сторонних платформах"},{"href":"/ru/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-kubernetes-service","title":"Azure Kubernetes Service"}],"documentType":"article"},"body":"# Deploying to Azure Kubernetes Service\n\nУзнайте, как развернуть проект в Azure Kubernetes Service (AKS) в рамках рабочего процесса непрерывного развертывания (CD).\n\n## Необходимые компоненты\n\nПеред созданием рабочего процесса GitHub Actions сначала нужно выполнить следующие действия по настройке:\n\n1. Создайте целевой кластер AKS и Azure Container Registry (ACR). Для получения дополнительной информации см. [Быстрый старт: Развернуть кластер AKS с помощью портала Azure — Azure Kubernetes Service](https://docs.microsoft.com/azure/aks/kubernetes-walkthrough-portal) и [Quickstart — создать реестр в портале — Azure Container Registry](https://docs.microsoft.com/azure/container-registry/container-registry-get-started-portal) в документации Azure.\n\n1. Создайте секрет под названием `AZURE_CREDENTIALS` для хранения ваших учетных данных Azure. Для получения дополнительной информации о том, как найти эту информацию и структурировать секрет, см. [документацию по действиям `Azure/login`](https://github.com/Azure/login#configure-a-service-principal-with-a-secret).\n\n## Создание рабочего процесса\n\nВыполнив предварительные требования, можно приступить к созданию рабочего процесса.\n\nСледующий пример рабочего процесса демонстрирует, как построить и развернуть проект в Azure Kubernetes Service, когда код отправляется в ваш репозиторий.\n\nПод ключом рабочего процесса `env` измените следующие значения:\n* `AZURE_CONTAINER_REGISTRY` на имя реестра контейнеров;\n* `PROJECT_NAME` на имя проекта;\n* `RESOURCE_GROUP` на группу ресурсов, содержащую кластер AKS;\n* `CLUSTER_NAME` на имя кластера AKS.\n\nЭтот рабочий процесс использует движок рендера `helm` для действия [`azure/k8s-bake`](https://github.com/Azure/k8s-bake). Если вы будете использовать обработчик отрисовки `helm`, измените значение `CHART_PATH` на путь к файлу helm. Измените значение `CHART_OVERRIDE_PATH` на массив переопределенных путей к файлам. При использовании другого обработчика отрисовки обновите входные параметры, отправленные в действие `azure/k8s-bake`.\n\n```yaml copy\n# Этот рабочий процесс использует действия, которые не сертифицированы GitHub.\n# Они предоставляются сторонним поставщиком, и на них распространяются\n# отдельные условия обслуживания, политика конфиденциальности и поддержка\n# документации.\n\n# GitHub рекомендует закрепить действия в фиксации SHA.\n# Чтобы получить более новую версию, потребуется обновить SHA.\n# Вы также можете ссылаться на тег или ветвь, однако действие может измениться без предупреждения.\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## Дополнительные материалы\n\n* Исходный шаблон рабочего процесса см[`azure-kubernetes-service.yml`](https://github.com/actions/starter-workflows/blob/main/deployments/azure-kubernetes-service.yml). в репозитории GitHub Actions . `starter-workflows`\n* В этом рабочем процессе используются официальные 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) и [`Azure/k8s-deploy`](https://github.com/Azure/k8s-deploy)actions.\n* Больше примеров рабочих процессов GitHub Action, которые развертываются в Azure, смотрите репозиторий [actions-workflow-samples](https://github.com/Azure/actions-workflow-samples)."}