Usar una aplicación existente en Cloud Code para VS Code

Cloud Code aprovecha Skaffold de forma interna para ejecutar o depurar tu aplicación.

Si ya tienes una aplicación existente configurada con manifiestos de Kubernetes y un Dockerfile para compilar tus imágenes, puedes abrirla y usarla con Cloud Code.

La única configuración adicional necesaria es una configuración skaffold y una configuración de lanzamiento de tipo cloudcode.kubernetes. Cloud Code te guía para crearlos cuando ejecutas o depuras tu aplicación por primera vez.

Establece la configuración

Si tu aplicación tiene un Dockerfile, pero no tiene las configuraciones de Skaffold y de inicio necesarias, completa los siguientes pasos:

  1. Haz clic en Barra de estado de Cloud Code Cloud Code en la barra de estado y, luego, selecciona Ejecutar en Kubernetes o Depurar en Kubernetes.

  2. En el cuadro de diálogo Run/Debug en Kubernetes, especifica tu compilador preferido y su configuración. También puedes personalizar el nombre de la configuración.

    Captura de pantalla del cuadro de diálogo Configuración de compilación con campos de opciones de compilador y de nombre de configuración

    Si desarrollas software de silicio Apple M-Series, debes compilar una imagen que pueda ejecutarse en una arquitectura x86. Si quieres usar Cloud Build para compilar una imagen x86, selecciona la opción Cloud Build. Para obtener información sobre el costo de compilación de tu aplicación con Cloud Build, consulta Precios de Cloud Build.

  3. Haz clic en Debug o Run. La configuración de inicio del skaffold.yaml y el cloudcode.kubernetes recién creada se agrega a tu lugar de trabajo y tu app se ejecuta o está lista para la depuración.

    Captura de pantalla del cuadro de diálogo que notifica que la configuración y el árbol de archivos se agregó con el archivo skaffold.yaml y launch.json de forma correcta

Configura aplicaciones que ya tienen skaffold.yaml

Si tu aplicación ya tiene un archivo skaffold.yaml, sigue estos pasos:

  1. Haz clic en Barra de estado de Cloud Code Cloud Code en la barra de estado y, luego, selecciona Ejecutar en Kubernetes o Depurar en Kubernetes.

  2. Si hay más de un archivo skaffold.yaml en tu lugar de trabajo, selecciona tu archivo skaffold.yaml preferido.

  3. Si existe más de un perfil de Skaffold en el archivo skaffold.yaml que elegiste, selecciona el que prefieras.

    El documento creado recientemente cloudcode.kubernetes se agrega la configuración de lanzamiento a tu lugar de trabajo (en .vscode/launch.json) y tu app está en ejecución o está lista para ladepuración.

Crea una configuración Skaffold de forma manual

Es posible que quieras crear manualmente la configuración de Skaffold para definir opciones personalizadas. Cloud Code viene con plantillas activas para admitir la creación manual de la configuración de Skaffold.

Para crear manualmente una configuración de Skaffold, haz lo siguiente:

  1. Crea un archivo nuevo llamado skaffold.yaml en el directorio raíz de tu espacio de trabajo.

  2. En el archivo, presiona Command/Ctrl+Space para ver una lista de sugerencias de fragmentos y, luego, selecciona el fragmento Skaffold: Cómo comenzar.

    Crea la configuración de Skaffold de forma manual de Intellisense

  3. Ingresa el nombre de la imagen de tu proyecto en el campo image y, luego, ingresa una lista de los recursos de Kubernetes para implementar en el campo manifests.

    Ejemplos de compilaciones basadas en Dockerfile:

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

    Si deseas definir configuraciones de compilación, implementación y prueba para diferentes contextos, puedes tener diferentes perfiles de Skaffold. En el siguiente ejemplo, se muestra un perfil de Cloud Build para configurar Cloud Code a fin de compilar imágenes con Cloud Build:

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

    Para obtener más detalles sobre el esquema, consulta la referencia de skaffold.yaml.

Obtener asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.