API Gateway:Expose services with an APIG Ingress

Prérequis

• Vous avez créé un cluster managé ACK exécutant Kubernetes 1.18 ou une version ultérieure.

• Vous avez accordé les permissions requises à l'APIG Controller.

Installer l'APIG Controller

1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

2. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Components and Add-ons .

3. Sur la page Add-ons, recherchez APIG et cliquez sur Install sur la carte APIG Controller.

4. Dans la boîte de dialogue Install APIG Controller, configurez les paramètres et cliquez sur OK.

   • Create :

     Crée automatiquement une instance de passerelle API native cloud en paiement à l'utilisation avec la spécification apig.small.x1.

     Important

     • Lorsque vous sélectionnez Create, une ressource ApigConfig et une instance de passerelle API native cloud sont automatiquement créées. La suppression de la ressource ApigConfig entraîne également la suppression de l'instance de passerelle associée. Ne supprimez pas la ressource ApigConfig.

     • Si un IngressClass nommé apig existe déjà dans le cluster, le module complémentaire ne crée ni ressource ApigConfig ni instance de passerelle.

   • Select Existing VPC :

     Sélectionnez une instance existante de passerelle API native cloud en paiement à l'utilisation. L'instance doit se trouver dans le même VPC que le cluster et ne doit pas être liée à un autre cluster. Si l'instance que vous souhaitez utiliser n'apparaît pas dans la liste, vérifiez si elle est déjà liée à un autre cluster. Les instances déjà liées n'apparaissent pas dans la liste. Dans ce cas, sélectionnez Create pour créer une nouvelle instance de passerelle API native cloud.

   Si une erreur Failed to pass the precheck. survient lors de l'installation, accordez les permissions requises à l'APIG Controller .

5. Après l'installation, une ressource ApigConfig nommée apig-controller-pro-{clusterid} est créée dans le cluster. Dans la console Cloud-native API Gateway, une instance de passerelle nommée apig-controller-pro-{clusterid} apparaît dans la région correspondante.

Créer un exemple d'application

1. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Workloads > Deployments.

2. Sur la page Deployments, cliquez sur Create from YAML. Utilisez le code YAML suivant pour déployer un Deployment nommé httpbin et un Service nommé httpbin.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: httpbin
     template:
       metadata:
         labels:
           app: httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse-ingress/go-httpbin
             args:
               - "--version=v1"
             imagePullPolicy: Always
             name: httpbin
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: httpbin
     namespace: default
   spec:
     ports:
       - port: 8080
         protocol: TCP
     selector:
       app: httpbin
     type: ClusterIP

3. Cliquez sur View et vérifiez que le statut du pod est Running.

Configurer l'Ingress APIG

1. Dans le volet de navigation de gauche, choisissez Ingresses > Ingresses. Sur la page Ingresses, cliquez sur Create Ingress.

2. Dans la boîte de dialogue Create Ingress, définissez Gateway Type sur APIG Ingress, Ingresses sur Prefix Match et Path sur / pour transférer les requêtes vers le service httpbin, puis cliquez sur OK.

3. Sur la page Ingresses, repérez le point de terminaison Ingress dans la colonne Endpoint. Accédez à endpoint/version ou gateway public IP/version depuis un navigateur ou la CLI. Une réponse version: v1 confirme que l'Ingress fonctionne.

4. Connectez-vous à la console Cloud-native API Gateway. Dans l'instance de passerelle correspondante, recherchez une API dont le nom contient {gwid}-ingress.

Références

Gérer l'Ingress APIG