Déployer une application de serveur Web conteneurisée

Créer un registre Harbor géré

GDC air-gapped fournit Harbor en tant que service. Il s'agit d'un service entièrement géré qui vous permet de stocker et de gérer des images de conteneurs à l'aide de Harbor.

Pour utiliser Harbor en tant que service, vous devez d'abord créer une instance de registre Harbor et un projet Harbor.

Créer une instance de registre Harbor

Pour créer une instance de registre de conteneurs Harbor, procédez comme suit :

Créer un projet Harbor dans le registre

Vous devez créer un projet Harbor dans l'instance de registre Harbor pour gérer vos images de conteneurs :

Configurer Docker

Pour utiliser Docker dans votre registre Harbor, procédez comme suit :

1. Configurez Docker pour qu'il fasse confiance à Harbor en tant que service. Pour en savoir plus, consultez Configurer Docker pour qu'il fasse confiance à l'autorité de certification racine Harbor.

2. Configurez l'authentification Docker sur Harbor. Pour en savoir plus, consultez Configurer l'authentification Docker pour les instances de registre Harbor.

Créer un secret Kubernetes pour l'extraction d'images

Étant donné que vous utilisez un projet Harbor privé, vous devez créer un secret Kubernetes pour extraire les images.

1. Ajoutez un compte robot de projet Harbor pour qu'il serve de compte de service.

   1. Dans la console Harbor, sélectionnez votre projet Harbor.

   2. Cliquez sur Comptes de robot.

   3. Sélectionnez New Robot Account (Nouveau compte robot).

   4. Attribuez un nom à votre nouveau compte robot et définissez les paramètres supplémentaires.

   5. Cliquez sur Ajouter.

   6. Le nom et le secret du compte robot s'affichent sur l'écran de confirmation. Gardez cet écran ouvert pour vous y référer lors de la prochaine étape.

   Pour en savoir plus, consultez la documentation de Harbor : https://goharbor.io/docs/2.8.0/working-with-projects/project-configuration/create-robot-accounts/#add-a-robot-account.

2. Dans une nouvelle fenêtre de terminal, connectez-vous à Docker avec le compte robot et le jeton secret de votre projet Harbor :

   docker login ${INSTANCE_URL}
   

   Lorsque vous y êtes invité, insérez le nom du projet robot pour le nom d'utilisateur et le jeton secret pour le mot de passe qui ont été fournis à l'étape précédente à partir de l'écran de réussite de la console Harbor.

3. Définissez un nom arbitraire pour le secret d'extraction d'image :

   export SECRET=SECRET
   

4. Créez le secret requis pour l'extraction de l'image :

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

   Remplacez DOCKER_CONFIG par le chemin d'accès au fichier .docker/config.json.

5. Vérifiez que votre secret existe dans l'espace de noms de votre projet GDC :

   kubectl get secrets -n ${NAMESPACE}
   

   Le résultat ressemble à ce qui suit :

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

Transférer une image de conteneur vers le registre Harbor géré

Pour ce tutoriel, vous allez télécharger et transférer l'image du serveur Web nginx vers le registre Harbor géré, puis l'utiliser pour déployer un exemple d'application de serveur Web nginx sur un cluster Kubernetes. L'application de serveur Web nginx est disponible dans le dépôt public Docker Hub.

1. Extrayez l'image nginx de Docker Hub vers votre poste de travail local à l'aide d'un réseau externe :

   docker pull nginx
   

2. Ajoutez à l'image locale le tag correspondant au nom du dépôt :

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

3. Transférez l'image de conteneur nginx vers votre registre Harbor géré :

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

Créer un cluster Kubernetes

Maintenant que l'image de conteneur nginx est stockée dans le registre Harbor géré et que vous pouvez y accéder, créez un cluster Kubernetes pour exécuter le serveur Web nginx.

Pour en savoir plus sur la création d'un cluster Kubernetes, consultez Créer un cluster Kubernetes.

Déployer l'exemple d'application de conteneur

Vous êtes maintenant prêt à déployer l'image de conteneur nginx sur votre cluster Kubernetes.

Kubernetes représente les applications sous forme de ressources Pod, qui sont des unités évolutives contenant un ou plusieurs conteneurs. Le pod est la plus petite unité déployable dans Kubernetes. Généralement, vous déployez les pods sous la forme d'un ensemble d'instances dupliquées pouvant être mises à l'échelle et réparties sur votre cluster. Pour déployer un ensemble de répliques, vous pouvez utiliser un Deployment Kubernetes.

Dans cette section, vous allez créer un Deployment Kubernetes pour exécuter l'application de conteneur nginx sur votre cluster. Ce déploiement possède des répliques ou des pods. Un pod Deployment ne contient qu'un seul conteneur : l'image de conteneur nginx. Vous créez également une ressource Service qui fournit aux clients un moyen stable d'envoyer des requêtes aux pods de votre Deployment.

Déployez le serveur Web nginx sur votre cluster Kubernetes :

1. Connectez-vous au cluster Kubernetes et générez son fichier kubeconfig avec une identité utilisateur. Définissez le chemin d'accès kubeconfig en tant que variable d'environnement :

   export KUBECONFIG=CLUSTER_KUBECONFIG_PATH
   

2. Créez et déployez les ressources personnalisées Kubernetes Deployment et Service :

   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. Vérifiez que les pods ont été créés par le déploiement :

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

   Le résultat ressemble à ce qui suit :

   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. Créez une règle de réseau pour autoriser tout le trafic réseau vers l'espace de noms :

   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. Exportez l'adresse IP du service nginx :

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

6. Testez l'adresse IP du serveur nginx à l'aide de curl :

     curl http://$IP