Como usar um aplicativo atual

O Cloud Code usa o Skaffold em segundo plano para executar ou depurar seu aplicativo.

Se você já tiver um aplicativo configurado com os manifestos do Kubernetes e um Dockerfile para criar suas imagens, é possível abri-lo e usá-lo com o Cloud Code.

A única configuração extra necessária é uma configuração de skaffold e uma configuração de inicialização do tipo cloudcode.kubernetes. O Cloud Code ajuda você a criá-los ao executar ou depurar seu aplicativo pela primeira vez.

Como definir a configuração

Se o aplicativo tem um Dockerfile, mas não tem as configurações de Skaffold e launch necessárias, conclua as etapas a seguir:

  1. Selecione Run on Kubernetes ou Debug on Kubernetes na barra de status do Cloud Code.

    Como escolher "Executar no Kubernetes" na barra de status do Cloud Code

  2. Na caixa de diálogo Executar/Depurar no Kubernetes, especifique o builder e as configurações dele. Também é possível personalizar o nome da configuração.

    Captura de tela da caixa de diálogo "Configurações da versão" com opções do Builder e campos "Nome da configuração"

    Se você estiver desenvolvendo no silício da série Apple M, será necessário criar uma imagem que possa ser executada em uma arquitetura x86. Para usar o Cloud Build para criar uma imagem x86, selecione a opção do Cloud Build. Para saber informações sobre o custo da criação do aplicativo usando o Cloud Build, consulte Preços do Cloud Build.

  3. Clique em Depurar ou Executar. As configurações de inicialização skaffold.yaml e cloudcode.kubernetes recém-criadas foram adicionadas ao espaço de trabalho e o aplicativo é executado ou pronto para depuração.

    Captura de tela da caixa de diálogo que notifica a adição da configuração e a árvore de arquivos com skaffold.yaml e launch.json

Definição de configuração para aplicativos que já têm skaffold.yaml

Se o aplicativo já tiver um arquivo skaffold.yaml, siga estas etapas:

  1. Selecione Run on Kubernetes ou Debug on Kubernetes na barra de status do Cloud Code.

    Como escolher "Executar no Kubernetes" na barra de status do Cloud Code

  2. Se houver mais de um arquivo skaffold.yaml no espaço de trabalho, selecione o arquivo skaffold.yaml de sua preferência.

    Selecionar o arquivo de configuração do skaffold

  3. Se houver mais de um perfil do Skaffold no arquivo skaffold.yaml escolhido, selecione seu perfil preferido do Skaffold.

    Selecionar o perfil do Skaffold

    A configuração de inicialização cloudcode.kubernetes recém-criada foi adicionada ao espaço de trabalho (em .vscode/launch.json) e o aplicativo está em execução ou pronto para debugging.

Como criar manualmente uma configuração do Skaffold

Convém criar sua configuração do Skaffold para definir opções personalizadas. O Cloud Code é fornecido com modelos dinâmicos para permitir a criação manual de configurações do Skaffold.

Para criar manualmente uma configuração do Skaffold:

  1. Crie um novo arquivo chamado skaffold.yaml no diretório raiz do seu espaço de trabalho.

  2. No arquivo, pressione Command/Ctrl+Space para ver uma lista de sugestões de snippets e, em seguida, selecione o snippet Skaffold - Started-started.

    Criar a configuração do Skaffold manualmente

  3. Digite o nome da imagem do projeto no campo image e insira uma lista dos recursos do Kubernetes a serem implantados no campo manifests.

    Exemplo para compilações baseadas no Dockerfile:

    build:
      artifacts:
        - image: image_name
    deploy:
      kubectl:
        manifests:
          - k8s/web.yaml
          - k8s/backend.yaml
    

    Se você quiser definir configurações de criação, teste e implantação para diferentes contextos, é possível ter perfis diferentes do Skaffold. Na amostra a seguir, mostramos um perfil do Cloud Build para configurar o Cloud Code para criar imagens com o Cloud Build:

    profiles:
    # use the cloudbuild profile to build images using Google Cloud Build
    - name: cloudbuild
      build:
        googleCloudBuild: {}
    

    Para detalhes completos do esquema, consulte a referência do skaffold.yaml.

Como receber suporte

Para enviar feedback, relate problemas no GitHub ou faça uma pergunta no Stack Overflow.