Guía de inicio rápido

En esta página, se muestra cómo comenzar a usar Cloud Code con tu propio proyecto de Kubernetes o con la aplicación de muestra Hello World para Java.

Puedes elegir cualquiera de las otras muestras hello-world de Cloud Code y seguir los pasos que se indican en este documento, siempre y cuando tu sistema y también IntelliJ IDEA (o cualquier otro IDE de JetBrains) estén configurados para admitir el lenguaje que elijas.

Antes de comenzar

Se espera que las siguientes herramientas estén instaladas y configuradas en tu sistema, además de que se encuentren disponibles en PATH en tu máquina:

  • IDE de JetBrains, versión 2018.2 o posterior (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm y GoLand)
  • Cliente Docker (autenticado con tu registro de Docker)
  • kubectl (instalado mediante gcloud components install kubectl si usas el SDK de Cloud)
  • Skaffold
  • Clúster de Kubernetes configurado

Instala el complemento

Para instalar el complemento de Cloud Code, haz lo siguiente:

  • Abre IntelliJ IDEA (o cualquier IDE de JetBrains admitido).
  • Busca el complemento “Cloud Code” en el mercado de complementos (Archivo [File] > Configuración [Settings] > Complementos [Plugins], o, en macOS, IntelliJ IDEA > Preferencias [Preferences] > Complementos [Plugins]) y, luego, instálalo. Es posible que debas reiniciar tu IDE para activar el complemento.

Agrega compatibilidad con Cloud Code a proyectos de Kubernetes existentes

Para agregar compatibilidad con Cloud Code a proyectos de Kubernetes existentes, sigue estos pasos:

  • Si el proyecto tiene un Dockerfile y recursos de Kubernetes, Cloud Code te mostrará una notificación para crear automáticamente los archivos de configuración y objetivos de ejecución necesarios.

    Crear notificaciones objetivo de Kubernetes

    Cuando se hayan creado, podrás usar las funciones de implementación y desarrollo continuos de Cloud Code en tu proyecto.

  • Como alternativa, puedes usar Herramientas (Tools) > Cloud Code > Kubernetes > Agregar compatibilidad con Kubernetes (Add Kubernetes Support) para analizar los recursos de Kubernetes del proyecto, generar una configuración de Skaffold y agregar dos configuraciones de ejecución para la implementación y la implementación continua en un clúster de Kubernetes.

Crea una aplicación

Para crear una aplicación con una muestra existente, sigue estos pasos:

  • Descarga la aplicación de muestra Hello World para Java desde el repositorio de GitHub de muestras de Cloud Code.
  • En IntelliJ IDEA, importa el proyecto "java-hello-world" (desde el directorio cloud-code-samples/java/).
  • Se te pedirá crear automáticamente objetivos de ejecución del IDE de Kubernetes para la implementación y el desarrollo continuo del proyecto con una notificación.

    Haz clic en el vínculo “Crear configuraciones de ejecución de Kubernetes para Cloud Code” (Create Cloud Code Kubernetes Run Configurations).

    Crear notificaciones objetivo de Kubernetes

  • Opcional: También puedes crear los objetivos de ejecución manualmente.

    • Haz clic en el menú desplegable “Configuración de ejecución” (Run Configuration) y selecciona “Editar configuraciones” (Edit Configurations).
    • Haz clic en el botón del signo más “Agregar configuración nueva” (Add New Configuration) para agregar una configuración de ejecución nueva.
    • Navega hasta “Cloud Code: Kubernetes” y selecciona “Kubernetes Continuous Deploy” o “Kubernetes Deploy”.

      Opción “Cloud Code: Kubernetes” del menú

    • Ingresa un nombre para la configuración nueva.

    • Haz clic en “Aceptar” (OK) para crear el objetivo de ejecución.

Implementa tu aplicación

Para implementar una aplicación, haz lo siguiente:

  • Asegúrate de que tengas acceso a un repositorio de imágenes de contenedor que use el proyecto.

    Para reemplazar el repositorio de imágenes del proyecto, especifícalo mediante el cuadro de diálogo “Configuraciones de ejecución/depuración” (Run/Debug configurations) de la barra de tareas superior, en el menú Editar configuraciones… (Edit Configurations…) > Kubernetes Deploy/Continuous Deploy > Opciones de imágenes (Image Options) > Repositorio de imágenes predeterminado (Default image repository).

    Por ejemplo, en Docker Hub, usa "docker.io/{cuenta}".

  • Ahora que tu aplicación está lista para implementarse, puedes hacerlo si seleccionas Kubernetes Deploy en el cuadro de diálogo “Configuraciones de ejecución/depuración” (Run/Debug configurations) de la barra de tareas superior.

    Configuraciones de ejecución para la implementación en Kubernetes

Inicia la implementación continua

Para iniciar la implementación continua de tu aplicación, haz lo siguiente:

  • Elige el objetivo de ejecución Kubernetes Continuous Deploy en el cuadro de diálogo “Configuraciones de ejecución/depuración” (Run/Debug configurations) de la barra de tareas superior para volver a implementar continuamente los cambios y supervisar los registros de la aplicación.

    Se compilarán, enviarán y también implementarán automáticamente todos los cambios que se realicen en tu código, y se guardarán en una versión nueva de tu aplicación.

  • En la ventana de salida, podrás visualizar los registros de la aplicación. Cuando se inicie la implementación, verás la lista de puertos redireccionados de la aplicación implementada.

  • Puedes acceder a tu aplicación de forma local mediante uno de los puertos que se mencionan.

    Visualizar registros transmitidos desde la aplicación de Kubernetes

Depura tu aplicación

Para depurar tu aplicación, haz lo siguiente:

  • Para comenzar el ciclo de desarrollo en el modo de depuración de tu clúster de Kubernetes, haz clic en la acción correspondiente para el complemento Kubernetes Continuous Deploy.

    Iniciar el ciclo de desarrollo del clúster de Kubernetes en modo de depuración

  • Cloud Code adjuntará una sesión de depuración.

    Ahora puedes realizar todas las tareas que haces normalmente cuando depuras código local, como establecer interrupciones y revisar el código paso a paso, pero con la ventaja adicional de poder depurar con un clúster activo de Kubernetes.

Pasos siguientes

Obtén asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Cloud Code para IntelliJ