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

  • Artigo

Draft é um projeto de software livre que simplifica o desenvolvimento do Kubernetes usando um aplicativo não conteinerizado e gerando os Dockerfiles, os manifestos do Kubernetes, os gráficos do Helm, as configurações do Kustomize e outros artefatos associados a um aplicativo conteinerizado. O Draft também pode criar um arquivo de fluxo de trabalho do GitHub Actions para criar e implantar aplicativos rapidamente nos clusters do 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 GitHub OIDC.
  • draft generate-workflow: gera o arquivo de fluxo de trabalho do GitHub Actions para implantação no cluster.
  • draft up: configura o GitHub OIDC e gera um arquivo de fluxo de trabalho do GitHub Actions, combinando os dois comandos anteriores.

Pré-requisitos

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

Instale a extensão aks-preview da CLI do Azure

Importante

As versões prévias do recurso AKS estão disponíveis em uma base de autoatendimento e aceitação. As visualizações são fornecidas "como estão" e "conforme disponíveis" e estão excluídas dos acordos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. 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 o GitHub OIDC usandodraft setup-gh

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

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

Depois de criar os artefatos e configurar o 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 o aplicativo no cluster do AKS. Depois que o arquivo de fluxo de trabalho for gerado, você deverá confirmá-lo no repositório para iniciar o GitHub Actions.

  • Gerar um arquivo de fluxo de trabalho do 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 o GitHub OIDC (OpenID Connect) e gerar um arquivo de fluxo de trabalho do GitHub Actions usando draft up

draft upé um único comando para realizar a instalação do GitHub OIDC 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 do GitHub Actions podem ser feitas usando draft generate-workflow.

  • Configurar o GitHub OIDC e gerar um arquivo de fluxo de trabalho do 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 rascunho para tornar o aplicativo acessível pela Internet

O Roteamento de Aplicativos]app-routing é a maneira mais fácil de colocar seu aplicativo Web em funcionamento 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