Compartilhar via

Rascunho para AKS (Serviço de Kubernetes do Azure) (versão prévia)

Draft é um projeto de código aberto que simplifica o desenvolvimento do Kubernetes, pegando uma aplicação não conteinerizada e gerando os Dockerfiles, manifestos do Kubernetes, gráficos do Helm, configurações do Kustomize e outros artefatos associados a um aplicativo conteinerizado. Draft também pode criar um arquivo de fluxo de trabalho do GitHub Actions para criar e implantar aplicativos rapidamente em qualquer cluster Kubernetes.

Como ele funciona

O Draft tem os seguintes comandos para ajudar a facilitar o desenvolvimento no Kubernetes:

  • draft create: cria o Dockerfile e os arquivos de manifesto apropriados.
  • draft setup-gh: configura o OIDC de GitHub.
  • draft generate-workflow: gera o arquivo de fluxo de trabalho GitHub Action para implantação em seu cluster.
  • draft up: configura o OIDC GitHub e gera um arquivo de fluxo de trabalho GitHub Action, combinando os dois comandos anteriores.

Pré-requisitos

  • Se você não tiver uma assinatura Azure, crie uma conta gratuita antes de começar.
  • Instale a versão mais recente da extensão CLI do Azure e aks-preview.
  • Se você ainda não tiver um, precisará criar um cluster AKS e uma instância de Registro de Contêiner do Azure.

Instalar a extensão aks-preview CLI do Azure

Importante

As funcionalidades de visualização do AKS estão disponíveis em uma base de autoatendimento e opção de adesão. As versões prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As prévias do AKS são parcialmente cobertas pelo suporte ao cliente com base no melhor esforço possível. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:

  1. Instale a extensão aks-preview usando o comando az extension add.

    az extension add --name aks-preview

  2. Atualize a extensão para garantir que você tenha a versão mais recente usando o comando az extension update.

    az extension update --name aks-preview

Criar artefatos usando draft create

Você pode usar draft create para criar dockerfiles, gráficos do Helm, manifestos do Kubernetes ou arquivos do Kustomize necessários para implantar seu aplicativo em um cluster do AKS.

  • Crie um artefato usando o comando az aks draft create.

    az aks draft create

    • Você também pode executar o comando em um diretório específico usando o sinalizador --destination, conforme mostrado no exemplo a seguir:

      az aks draft create --destination /Workspaces/ContosoAir

Configurar GitHub OIDC usando draft setup-gh

Para usar o Rascunho, você precisa registrar seu aplicativo com GitHub usando draft setup-gh. Essa etapa só precisa ser feita uma vez por repositório.

Gerar um arquivo de fluxo de trabalho da Ação GitHub para implantação usando draft generate-workflow

Depois de criar seus artefatos e configurar GitHub OIDC, você pode usar draft generate-workflow para gerar um arquivo de fluxo de trabalho do GitHub Action, criando uma ação que implanta seu aplicativo no cluster do AKS. Depois que o arquivo de fluxo de trabalho for gerado, você deverá confirmá-lo em seu repositório para iniciar a Ação GitHub.

  • Gere um arquivo de fluxo de trabalho GitHub Action usando o comando az aks draft generate-workflow.

    az aks draft generate-workflow

    • Você também pode executar o comando em um diretório específico usando o sinalizador --destination, conforme mostrado no exemplo a seguir:

      az aks draft generate-workflow --destination /Workspaces/ContosoAir

Configurar GitHub OpenID Connect (OIDC) e gerar um arquivo de workflow do GitHub Actions usando draft up

draft up é um único comando para realizar a configuração OIDC do GitHub e gerar um arquivo de fluxo de trabalho do GitHub Actions para implantação. Ele combina efetivamente os comandos draft setup-gh e draft generate-workflow, o que significa que é mais comumente usado ao iniciar um novo repositório pela primeira vez e só precisa ser executado uma vez. As atualizações subsequentes para o arquivo de fluxo de trabalho GitHub Action podem ser feitas usando draft generate-workflow.

  • Configure GitHub OIDC e gere um arquivo de fluxo de trabalho GitHub Action usando o comando az aks draft up.

    az aks draft up

    • Você também pode executar o comando em um diretório específico usando o sinalizador --destination, conforme mostrado no exemplo a seguir:

      az aks draft up --destination /Workspaces/ContosoAir

Usar o Roteamento de Aplicativos com o Draft para tornar o aplicativo acessível pela Internet

O Roteamento de Aplicativos é a maneira mais fácil de colocar seu aplicativo Web em execução no Kubernetes com segurança. O Roteamento de Aplicativos elimina a complexidade dos controladores de entrada e do gerenciamento de certificados e DNS, além de oferecer configuração para empresas que desejam trazer seus próprios controladores. O Roteamento de Aplicativos oferece um controlador de entrada gerenciado com base no nginx que você pode usar sem restrições, além de ser integrado imediatamente ao Open Service Mesh para proteger as comunicações intra-cluster.

  • Configure o rascunho com o Roteamento de Aplicativos usando az aks draft update e informe o nome DNS e o certificado armazenado do Azure Key Vault quando solicitado.

    az aks draft update

    • Você também pode executar o comando em um diretório específico usando o sinalizador --destination, conforme mostrado no exemplo a seguir:

      az aks draft update --destination /Workspaces/ContosoAir
  • Last updated on