Desplegar una aplicación de servidor web en un contenedor

Crear un registro de Harbor gestionado

GDC air-gapped proporciona Harbor como servicio, que es un servicio totalmente gestionado que te permite almacenar y gestionar imágenes de contenedor con Harbor.

Para usar Harbor como servicio, primero debes crear una instancia de registro de Harbor y un proyecto de Harbor.

Crear una instancia de registro de Harbor

Para crear una instancia de registro de contenedores de Harbor, sigue estos pasos:

Crear un proyecto de Harbor en el registro

Debes crear un proyecto de Harbor en la instancia del registro de Harbor para gestionar tus imágenes de contenedor:

Configurar Docker

Para usar Docker en tu registro de Harbor, sigue estos pasos:

1. Configura Docker para que confíe en Harbor como servicio. Para obtener más información, consulta Configurar Docker para que confíe en la CA raíz de Harbor.

2. Configura la autenticación de Docker en Harbor. Para obtener más información, consulta Configurar la autenticación de Docker en instancias del registro de Harbor.

Crear un secreto de extracción de imágenes de Kubernetes

Como estás usando un proyecto privado de Harbor, debes crear un secreto de extracción de imágenes de Kubernetes.

1. Añade una cuenta de robot de proyecto de Harbor para que actúe como tu cuenta de servicio.

   1. En la consola de Harbor, selecciona tu proyecto de Harbor.

   2. Haz clic en Cuentas de robot.

   3. Selecciona New Robot Account (Nueva cuenta de robot).

   4. Asigna un nombre a la nueva cuenta de robot y define los ajustes adicionales que quieras.

   5. Haz clic en Añadir.

   6. El nombre y el secreto de la cuenta de robot se muestran en la pantalla de confirmación. Mantén esta pantalla abierta para consultarla en el paso siguiente.

   Para obtener más información, consulta la documentación de Harbor: https://goharbor.io/docs/2.8.0/working-with-projects/project-configuration/create-robot-accounts/#add-a-robot-account.

2. En una nueva ventana de terminal, inicia sesión en Docker con tu cuenta de robot y token secreto del proyecto de Harbor:

   docker login ${INSTANCE_URL}
   

   Cuando se te pida, inserta el nombre del proyecto del robot en el campo Nombre de usuario y el token secreto en el campo Contraseña que se te proporcionaron en el paso anterior en la pantalla de confirmación de la consola de Harbor.

3. Asigna un nombre arbitrario al secreto de extracción de imágenes:

   export SECRET=SECRET
   

4. Crea el secreto necesario para extraer la imagen:

   kubectl create secret docker-registry ${SECRET}  \
       --from-file=.dockerconfigjson=DOCKER_CONFIG \
       -n ${NAMESPACE}
   

   Sustituye DOCKER_CONFIG por la ruta al archivo .docker/config.json.

5. Confirma que tu secreto existe en el espacio de nombres de tu proyecto de GDC:

   kubectl get secrets -n ${NAMESPACE}
   

   El resultado debería ser similar al siguiente:

   NAME          TYPE                               DATA     AGE
   my-secret     kubernetes.io/dockerconfigjson     1        23s
   

Enviar una imagen de contenedor a un registro de Harbor gestionado

En este tutorial, descargarás y enviarás la imagen del servidor web nginx al registro de Harbor gestionado y la usarás para desplegar una aplicación de servidor web nginx de ejemplo en un clúster de Kubernetes. La aplicación del servidor web nginx está disponible en el repositorio público de Docker Hub.

1. Extrae la imagen nginx de Docker Hub a tu estación de trabajo local mediante una red externa:

   docker pull nginx
   

2. Etiqueta la imagen local con el nombre del repositorio:

   docker tag nginx ${INSTANCE_URL}/${HARBOR_PROJECT}/nginx:1.25
   

3. Envía la imagen de contenedor nginx a tu registro de Harbor gestionado:

   docker push ${INSTANCE_URL}/${HARBOR_PROJECT}/nginx:1.25
   

Crear un clúster de Kubernetes

Ahora que tienes la imagen de contenedor nginx almacenada en el registro de Harbor gestionado y puedes acceder a ella, crea un clúster de Kubernetes para ejecutar el servidor web nginx.

Para obtener más información sobre cómo crear un clúster de Kubernetes, consulta el artículo Crear un clúster de Kubernetes.

Desplegar la aplicación de contenedor de ejemplo

Ahora ya puedes desplegar la imagen de contenedor nginx en tu clúster de Kubernetes.

Kubernetes representa las aplicaciones como Pod recursos, que son unidades escalables que contienen uno o varios contenedores. El pod es la unidad desplegable más pequeña de Kubernetes. Normalmente, los pods se implementan como un conjunto de réplicas que se pueden escalar y distribuir conjuntamente en el clúster. Una forma de desplegar un conjunto de réplicas es mediante un Deployment de Kubernetes.

En esta sección, crearás un Deployment de Kubernetes para ejecutar la aplicación de contenedor nginx en tu clúster. Este Deployment tiene réplicas o pods. Un pod Deployment contiene solo un contenedor: la imagen de contenedor nginx. También puedes crear un recurso Service que proporcione a los clientes una forma estable de enviar solicitudes a los pods de tu Deployment.

Despliega el servidor web nginx en tu clúster de Kubernetes:

1. Inicia sesión en el clúster de Kubernetes y genera su archivo kubeconfig con una identidad de usuario. Define la ruta de kubeconfig como una variable de entorno:

   export KUBECONFIG=CLUSTER_KUBECONFIG_PATH
   

2. Crea e implementa los recursos personalizados Deployment y Service de Kubernetes:

   kubectl --kubeconfig ${KUBECONFIG} -n ${NAMESPACE} \
   create -f - <<EOF
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: ${INSTANCE_URL}/${HARBOR_PROJECT}/nginx:1.25
           ports:
           - containerPort: 80
         imagePullSecrets:
         - name: ${SECRET}
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-service
   spec:
     selector:
       app: nginx
     ports:
       - port: 80
         protocol: TCP
     type: LoadBalancer
   EOF
   

3. Verifica que el despliegue haya creado los pods:

   kubectl get pods -l app=nginx -n ${NAMESPACE}
   

   El resultado debería ser similar al siguiente:

   NAME                                READY     STATUS    RESTARTS   AGE
   nginx-deployment-1882529037-6p4mt   1/1       Running   0          1h
   nginx-deployment-1882529037-p29za   1/1       Running   0          1h
   nginx-deployment-1882529037-s0cmt   1/1       Running   0          1h
   

4. Crea una política de red para permitir todo el tráfico de red al espacio de nombres:

   kubectl --kubeconfig ${KUBECONFIG} -n ${NAMESPACE} \
   create -f - <<EOF
   apiVersion: networking.k8s.io/v1
   kind: NetworkPolicy
   metadata:
     annotations:
     name: allow-all
   spec:
     ingress:
     - from:
       - ipBlock:
           cidr: 0.0.0.0/0
     podSelector: {}
     policyTypes:
     - Ingress
   EOF
   

5. Exporta la dirección IP del servicio nginx:

     export IP=`kubectl --kubeconfig=${KUBECONFIG} get service nginx-service \
         -n ${NAMESPACE} -o jsonpath='{.status.loadBalancer.ingress[*].ip}'`
   

6. Prueba la dirección IP del servidor nginx con curl:

     curl http://$IP