Utilisation d'Istio en tant que module complémentaire de grappe pour mettre en oeuvre l'API du service de passerelle Kubernetes

Étapes de haut niveau pour configurer le module complémentaire de grappe Istio en tant que contrôleur d'API de passerelle

À un niveau général, les étapes de configuration du module complémentaire de grappe Istio pour servir de contrôleur d'API Gateway sont les suivantes :

• Étape 1 : Installer les CRD d'API de passerelle
• Étape 2 : Créer le fichier de configuration du module complémentaire de grappe Istio
• Étape 3 : Déployer le module complémentaire de grappe Istio sur la grappe et vérifier que le déploiement a réussi
• Étape 4 : Créer une passerelle
• Étape 5 : déployer un exemple d'application
• Étape 6 : Créer un fichier HTTPRoute
• Étape 7 : Vérifier la connectivité

Étape 1 : Installer les CRD d'API de passerelle

Les définitions de ressources personnalisées d'API de passerelle ne sont pas installées par défaut dans les grappes que vous créez à l'aide de Kubernetes Engine. Avant d'utiliser Istio comme contrôleur d'API de passerelle, vous devez installer les CRD.

1. Installez les CRD d'API de passerelle standard (v1.2.0) en entrant :

   kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.2.0/standard-install.yaml
   

2. Vérifiez que le CRD est installé en entrant :

   kubectl get crd gateways.gateway.networking.k8s.io
   

3. Vérifiez que le CRD est répertorié dans la sortie.
4. Vérifiez que la version de l'API de passerelle Kubernetes est compatible avec la version du module complémentaire Istio prise en charge par Kubernetes Engine pour la version de Kubernetes exécutée sur la grappe (voir Comparaisons - v1.2 dans la documentation sur l'API de passerelle et Versions prises en charge du module complémentaire de grappe).

Étape 2 : Créer le fichier de configuration du module complémentaire de grappe Istio

Créez un fichier de configuration du module complémentaire de grappe Istio à utiliser avec l'interface de ligne de commande OCI.

1. Créez un fichier JSON (par exemple, enableistio.json).

2. Ajoutez le contenu suivant pour activer le module complémentaire.

   Note : Contrairement au cas d'utilisation standard du service de maillage de services, vous n'avez pas strictement besoin de définir enableIngressGateway existant, car l'API de passerelle peut provisionner dynamiquement l'infrastructure de passerelle. Toutefois, sa définition fournit un traitement de secours par défaut.

   {
       "addonName": "Istio",
       "configurations": [
           {
               "key": "enableIngressGateway",
               "value": "false"
           }
       ]
   }
   

   Notez les points suivants :

   • Si vous réglez value à "true", le module complémentaire de grappe Istio provisionne le déploiement et le service istio-ingressgateway classiques à côté du plan de contrôle.
   • Si vous réglez value à "false", seul le plan de contrôle (istiod) est installé. Vous pouvez ensuite créer des ressources Gateway qu'Istio provisionnera automatiquement selon les besoins.

3. Enregistrez le fichier et fermez-le.

Étape 3 : Déployer le module complémentaire de grappe Istio sur la grappe et vérifier que le déploiement a réussi

Déployez le module complémentaire de grappe Istio.

1. Déployez le module complémentaire à l'aide de l'interface de ligne de commande OCI en entrant :

   oci ce cluster install-addon --addon-name Istio --cluster-id <cluster-ocid> --from-json file://enableistio.json
   

2. Vérifiez que le déploiement a réussi :

   1. Entrez :

      oci ce cluster list-addons --cluster-id <cluster-ocid>
      

   2. Vérifiez que l'état du cycle de vie du module complémentaire de grappe Istio est ACTIVE.

3. Vérifiez que le plan de contrôle Istio est en cours d'exécution :

   1. Entrez :

      kubectl get pods -n istio-system
      

   2. Vérifiez que le pod istiod est à l'état Running.

Étape 4 : Créer une passerelle

Créez la ressource Gateway.

1. Créez un espace de noms (par exemple, test-gateway) en entrant :

   kubectl create namespace test-gateway

2. Créez un fichier nommé gateway.yaml avec le contenu suivant.

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway
   metadata:
     name: my-gateway
     namespace: test-gateway
     annotations:
       # OCI specific annotation for Network Load Balancer (Layer 4)
       oci.oraclecloud.com/load-balancer-type: "nlb"
   spec:
     gatewayClassName: istio
     listeners:
     - name: http
       port: 80
       protocol: HTTP
       allowedRoutes:
         namespaces:
           from: Same
   

   Notez la ligne gatewayClassName: istio, qui indique au module complémentaire de grappe Istio de gérer cette passerelle.

3. Créez Gateway en entrant :

   kubectl apply -f gateway.yaml
   

4. Obtenez l'adresse IP externe en entrant :

   kubectl get gateway -n test-gateway
   

   OCI peut prendre quelques minutes pour provisionner l'équilibreur de charge.

   Attendez que la colonne PROGRAMMED contienne True et qu'une adresse IP apparaisse dans la colonne ADDRESS.

Étape 5 : déployer un exemple d'application

Déployez un exemple d'application dans le nouvel espace de noms.

1. Déployez un exemple d'application (par exemple, httpbin) en entrant :

   
   kubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/httpbin/httpbin.yaml -n test-gateway
   

Étape 6 : Créer un fichier HTTPRoute

Créez un HTTPRoute pour diriger le trafic de Gateway vers le service httpbin.

1. Créez un fichier nommé route.yaml avec le contenu suivant :

   apiVersion: gateway.networking.k8s.io/v1
   kind: HTTPRoute
   metadata:
     name: httpbin-route
     namespace: test-gateway
   spec:
     parentRefs:
     - name: my-gateway
     rules:
     - matches:
       - path:
           type: PathPrefix
           value: /get
       backendRefs:
       - name: httpbin
         port: 8000
   

2. Créez HTTPRoute en entrant :

   kubectl apply -f route.yaml
   

Étape 7 : Vérifier la connectivité

Vérifiez la connectivité en envoyant une demande à l'adresse IP externe de Gateway.

1. Extrayez l'adresse IP publique de la passerelle et enregistrez-la en tant que variable d'environnement en entrant :

   export GATEWAY_IP=$(kubectl get gateway my-gateway -n test-gateway -o jsonpath='{.status.addresses[0].value}')

2. Utilisez curl pour envoyer une demande à l'adresse IP externe de la passerelle en entrant :

   curl -i http://$GATEWAY_IP/get
   

3. Confirmez que vous recevez une réponse 200 OK de l'application httpbin.