Partilhar via


Rascunho para o Serviço Kubernetes do Azure (AKS) (visualização)

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

Como funciona

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

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

Pré-requisitos

  • Se não tiver uma subscrição 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 tiver um, precisará criar um cluster AKS e uma instância do Registro de Contêiner do Azure.

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

Importante

Os recursos de visualização do AKS estão disponíveis em uma base de autosserviço e opt-in. As visualizaçõ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 visualizações do AKS são parcialmente cobertas pelo suporte ao cliente com base no melhor esforço. Como tal, estas funcionalidades não se destinam a utilização em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

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

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

    az extension update --name aks-preview
    

Crie artefatos usando draft create

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

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

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

      az aks draft create --destination /Workspaces/ContosoAir
      

Configurar o GitHub OIDC usando draft setup-gh

Para usar o Draft, você precisa registrar seu aplicativo no GitHub usando draft setup-gho . Esta etapa só precisa ser feita uma vez por repositório.

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

Depois de criar seus artefatos e configurar o OIDC do GitHub, 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 AKS. Depois que o arquivo de fluxo de trabalho for gerado, você deverá confirmá-lo em seu repositório para iniciar a Ação do GitHub.

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

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

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

Configure o GitHub OpenID Connect (OIDC) e gere um arquivo de fluxo de trabalho GitHub Action usando draft up

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

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

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

      az aks draft up --destination /Workspaces/ContosoAir
      

Use o Roteamento de Aplicativos com Rascunho para tornar seu aplicativo acessível pela Internet

Roteamento de aplicativos]o roteamento de aplicativos é 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 criar as suas. O Roteamento de Aplicativos oferece um controlador de entrada gerenciado baseado em nginx que você pode usar sem restrições e integra-se imediatamente ao Open Service Mesh para proteger as comunicações intra-cluster.

  • Configure o Rascunho com o Roteamento de Aplicativos usando o az aks draft update e passe o nome DNS e o certificado armazenado no Cofre da Chave do Azure quando solicitado.

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

      az aks draft update --destination /Workspaces/ContosoAir