Compartir comentarios
Las respuestas se generan en base a la documentación.

Inicio rápido

Tabla de contenidos

Sigue esta guía para comenzar a crear una extensión de Docker básica. La guía de inicio rápido genera automáticamente archivos de plantilla por ti.

Requisitos previos

Note

NodeJS y Go solo son necesarios cuando sigues la guía de inicio rápido para crear una extensión. Esta utiliza el comando docker extension init para generar automáticamente archivos de plantilla. Este comando utiliza una plantilla basada en una aplicación ReactJS y Go.

En la configuración de Docker Desktop, asegúrate de poder instalar la extensión que estás desarrollando. Es posible que debas navegar a la pestaña Extensions en la configuración de Docker Desktop y desmarcar Allow only extensions distributed through the Docker Marketplace.

Paso uno: Configurar tu directorio

Para configurar tu directorio, utiliza el subcomando init y proporciona un nombre para tu extensión.

$ docker extension init <my-extension>

El comando realiza una serie de preguntas sobre tu extensión, como su nombre, una descripción y el nombre de tu repositorio de Hub. Esto ayuda a la CLI a generar un conjunto de archivos de plantilla para que puedas comenzar. Almacena los archivos de plantilla en el directorio my-extension.

La extensión generada automáticamente contiene:

  • Un servicio de backend en Go en la carpeta backend que escucha en un socket. Tiene un endpoint /hello que devuelve un payload JSON.
  • Un frontend en React en la carpeta frontend que puede llamar al backend y mostrar la respuesta del backend.

Para obtener más información y directrices sobre la construcción de la interfaz de usuario, consulta la sección de Diseño y estilo de interfaz de usuario.

Paso dos: Construir la extensión

Para construir la extensión, dirígete al directorio recién creado y ejecuta:

$ docker build -t <name-of-your-extension> .

docker build construye la extensión y genera una imagen con el mismo nombre que el repositorio de Hub elegido. Por ejemplo, si escribiste john/my-extension como respuesta a la siguiente pregunta:

? Hub repository (eg. namespace/repository on hub): john/my-extension`

El comando docker build genera una imagen con el nombre john/my-extension.

Paso tres: Instalar y previsualizar la extensión

Para instalar la extensión en Docker Desktop, ejecuta:

$ docker extension install <name-of-your-extension>

Para previsualizar la extensión en Docker Desktop, una vez completada la instalación, deberías ver un elemento Quickstart bajo el menú Extensions. Al seleccionar este elemento se abre el frontend de la extensión.

Tip

Durante el desarrollo de la interfaz de usuario, es útil utilizar la recarga en caliente (hot reloading) para probar tus cambios sin tener que volver a construir toda la extensión. Consulta Previsualizar mientras se desarrolla la interfaz de usuario para obtener más información.

También es posible que quieras inspeccionar los contenedores que pertenecen a la extensión. Por defecto, los contenedores de la extensión están ocultos en el Panel de Docker (Docker Dashboard). Puedes cambiar esto en Settings; consulta cómo mostrar los contenedores de la extensión para obtener más información.

Paso cuatro: Enviar y publicar tu extensión en el Marketplace

Si quieres poner tu extensión a disposición de todos los usuarios de Docker Desktop, puedes enviarla para su publicación en el Marketplace. Para obtener más información, consulta Publicar.

Limpieza

Para eliminar la extensión, ejecuta:

$ docker extension rm <name-of-your-extension>

Qué sigue