Compartir vía

Draft para Azure Kubernetes Service (AKS) (versión preliminar)

  • Artículo

Draft es un proyecto de código abierto que simplifica el desarrollo con Kubernetes; para ello, toma una aplicación no contenedorizada y genera los archivos de Docker, los manifiestos de Kubernetes, los gráficos de Helm, las configuraciones de Kustomize y cualquier otro artefacto asociado a una aplicación contenedorizada. Draft también puede crear un archivo de flujo de trabajo de Acciones de GitHub para compilar e implementar aplicaciones rápidamente en cualquier clúster de Kubernetes.

Cómo funciona

Draft tiene los siguientes comandos para ayudar a facilitar el desarrollo con Kubernetes:

  • draft create: crea el archivo de Docker y los archivos de manifiesto que corresponda.
  • draft setup-gh: configura el OIDC de GitHub.
  • draft generate-workflow: genera el archivo de flujo de trabajo de Acciones de GitHub para la implementación en el clúster.
  • draft up: configura el OIDC de GitHub y genera un archivo de flujo de trabajo de Acciones de GitHub donde se combinan los dos comandos anteriores.

Prerrequisitos

  • Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
  • Instale la versión más reciente de la CLI de Azure y la extensión aks-preview.
  • Si todavía no tiene uno, debe crear un clúster de AKS y una instancia de Azure Container Service.

Instalación de la extensión de la CLI de Azure aks-preview

Importante

Las características en versión preliminar de AKS están disponibles como opción de participación y autoservicio. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles", y están excluidas de los Acuerdos de nivel de servicio y garantía limitada. Las versiones preliminares de AKS reciben cobertura parcial del soporte al cliente en la medida de lo posible. Por lo tanto, estas características no están diseñadas para su uso en producción. Para más información, consulte los siguientes artículos de soporte:

  1. Instale la extensión aks-preview mediante el comando az extension add.

    az extension add --name aks-preview

  2. Use la extensión para asegurarse de que tiene la versión más reciente mediante el comando az extension update.

    az extension update --name aks-preview

Creación de artefactos mediante draft create

Puede usar draft create para crear archivos Dockerfile, gráficos de Helm, manifiestos de Kubernetes o archivos Kustomize necesarios para implementar la aplicación en un clúster de AKS.

  • Cree un artefacto mediante el comando az aks draft create.

    az aks draft create

    • También puede ejecutar el comando en un directorio específico mediante la marca --destination, como se muestra en el ejemplo siguiente:

      az aks draft create --destination /Workspaces/ContosoAir

Configuración de OIDC de GitHub mediantedraft setup-gh

Para usar Draft, debe registrar la aplicación con GitHub mediante draft setup-gh. Este paso solo se debe hacer una vez por cada repositorio.

Generación de un archivo de flujo de trabajo de Acciones de GitHub para la implementación mediante draft generate-workflow

Después de crear los artefactos y configurar OIDC de GitHub, puede usar draft generate-workflow para generar un archivo de flujo de trabajo de Acciones de GitHub, lo que crea una acción que implementa la aplicación en el clúster de AKS. Una vez generado el archivo de flujo de trabajo, debe confirmarlo en el repositorio para iniciar la acción de GitHub.

  • Generación de un archivo de flujo de trabajo de Acciones de GitHub mediante el comando az aks draft generate-workflow.

    az aks draft generate-workflow

    • También puede ejecutar el comando en un directorio específico mediante la marca --destination, como se muestra en el ejemplo siguiente:

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

Configuración de OpenID Connect (OIDC) de GitHub y generación de un archivo de flujo de trabajo de Acciones de GitHub mediante draft up

draft up es un solo comando que permite configurar OIDC de GitHub y generar un archivo de flujo de trabajo de Acciones de GitHub para la implementación. Combina eficazmente los comandos draft setup-gh y draft generate-workflow, lo que significa que suele usarse con más frecuencia al empezar a trabajar en un nuevo repositorio por primera vez, y solo debe ejecutarse una vez. Las actualizaciones posteriores del archivo de flujo de trabajo de Acciones de GitHub se pueden realizar mediante draft generate-workflow.

  • Configuración de OIDC de GitHub y generación de un archivo de flujo de trabajo de Acciones de GitHub mediante el comando az aks draft up.

    az aks draft up

    • También puede ejecutar el comando en un directorio específico mediante la marca --destination, como se muestra en el ejemplo siguiente:

      az aks draft up --destination /Workspaces/ContosoAir

Utilice enrutamiento de aplicaciones con Draft para que su aplicación sea accesible a través de Internet

El enrutamiento de aplicaciones]app-routing es la forma más sencilla de poner en marcha su aplicación web en Kubernetes de forma segura. El enrutamiento de aplicaciones elimina la complejidad de los controladores de entrada y la gestión de certificados y DNS, y ofrece configuración para las empresas que deseen aportar la suya propia. El enrutamiento de aplicaciones ofrece un controlador de entrada administrado basado en nginx que puede utilizar sin restricciones y se integra de inmediato con la malla de servicios abiertos para proteger las comunicaciones dentro del clúster.

  • Configure Draft con el enrutamiento de aplicaciones mediante az aks draft update e introduzca el nombre DNS y el certificado almacenado en Azure Key Vault cuando se le solicite.

    az aks draft update

    • También puede ejecutar el comando en un directorio específico mediante la marca --destination, como se muestra en el ejemplo siguiente:

      az aks draft update --destination /Workspaces/ContosoAir