Associate an EIP with a pod

Prerequisites

• An ASK cluster is created or a virtual node is deployed in a Kubernetes cluster. For more information, see Create an ASK cluster and Virtual nodes.
• Required ports are exposed in the security group rules for the cluster. In the following example, port 80 is exposed.

Procedure

You can use the following methods to associate an EIP with a pod:

Method 1: Automatically associate an EIP with a pod

1. Log on to the Container Service for Kubernetes (ACK) console.
2. In the left-side navigation pane of the ACK console, click Clusters.
3. On the Clusters page, click the name of a cluster or click Details in the Actions column.
4. In the left-side navigation pane of the details page, choose Workloads > Deployments.
5. On the Deployments page, click Create from YAML, select a sample template or customize a template, and then click Create.
   You can use the following YAML template to create a pod. In this example, k8s.aliyun.com/eci-with-eip is set to true. This indicates that the ASK cluster or a virtual node automatically assigns and associates an EIP with the pod.

   apiVersion: v1
   kind: Pod
   metadata:
     name: nginx
     annotations:
       k8s.aliyun.com/eci-with-eip: "true"
     # k8s.aliyun.com/eip-bandwidth: '5' #Note: Do not set a unit for the specified bandwidth
   spec:
     containers:
     - image: nginx:alpine
       imagePullPolicy: Always
       name: nginx
       ports:
       - containerPort: 80
         name: http
         protocol: TCP
     restartPolicy: OnFailure

   Note

   • You can use the k8s.aliyun.com/eip-bandwidth annotation to specify the bandwidth limit of the EIP. Default value: 5. Unit: Mbit/s.
   • You can also use the k8s.aliyun.com/eip-common-bandwith-package-id annotation to associate the EIP with an EIP bandwidth plan.
   • If the YAML template creates a Deployment, the system assigns an EIP to each pod in the Deployment. Proceed with caution.
6. In the left-side navigation pane, choose Workloads > Pods to view the states of pods.
7. Find the pod that you want to manage and click Edit in the Actions column. The Edit YAML dialog box appears.
   Note In the YAML file of the pod, the IP address in the k8s.aliyun.com/allocated-eipAddress: 47.110.XX.XX field refers to the public IP address of the EIP.
8. Enter http://IP address into the address bar of a browser to visit the NGINX welcome page.

   http://IP address refers to the IP address in k8s.aliyun.com/allocated-eipAddress: 47.110.XX.XX of the YAML file.

   

   Note This method dynamically assigns an EIP to a pod. The lifecycle of the EIP is the same as that of the pod. If you delete the pod, the EIP assigned to the pod is automatically deleted.
9. Optional:If you want to specify a line for the EIP that is associated with an Elastic Container Instance-based pod, you must add the k8s.aliyun.com/eip-isp annotation and specify a value.
   ISP indicates the Internet connection type of the EIP. By default, this parameter is set to BGP. For more information, see AllocateEipAddressPro.

   The following YAML template provides an example:

   apiVersion: v1
   kind: Pod
   metadata:
     name: nginx
     annotations:
       k8s.aliyun.com/eci-with-eip: "true"
       k8s.aliyun.com/eip-isp: "BGP"
   spec:
     containers:
     - image: nginx:alpine
       name: nginx
       ports:
       - containerPort: 80
         name: http
         protocol: TCP
     restartPolicy: OnFailure

Method 2: Specify an EIP ID

1. Log on to the VPC console and apply for an EIP. For more information, see Apply for an EIP.
   Note The EIP that you apply for and the cluster must be deployed in the same region.
2. Log on to the Container Service for Kubernetes (ACK) console.
3. In the left-side navigation pane of the ACK console, click Clusters.
4. On the Clusters page, click the name of a cluster or click Details in the Actions column.
5. In the left-side navigation pane of the details page, choose Workloads > Deployments.
6. On the Deployments page, click Create from YAML, select a sample template or customize a template, and then click Create.

   You can use the following YAML template to create a pod. In this example, you can specify the ID of the EIP in the k8s.aliyun.com/eci-eip-instanceid annotation.

   apiVersion: v1
   kind: Pod
   metadata:
     name: nginx
     annotations:
       "k8s.aliyun.com/eci-eip-instanceid": "<youreipInstanceId>"
   spec:
     containers:
     - image: nginx:alpine
       imagePullPolicy: Always
       name: nginx
       ports:
       - containerPort: 80
         name: http
         protocol: TCP
     restartPolicy: OnFailure

   Note

   • Replace <youreipInstanceId> with the ID of the EIP obtained in Step 1.
   • If the system automatically assigns an EIP to a pod and you also specify an EIP for the pod, the EIP that you specify is not used.
7. In the left-side navigation pane, choose Workloads > Pods to view the states of pods.
8. Enter http://IP address into the address bar of a browser to visit the NGINX welcome page.
   

   Note http://IP address refers to the IP address of the EIP that you applied for in Step 1.