Bind an EIP to a pod

Prerequisites

• A serverless cluster is created or a virtual node is deployed on your cluster. For more information, see Create a serverless Kubernetes cluster and Virtual nodes.
• Required ports are enabled in the security group rules for the cluster. In the following example, port 80 is enabled.

Procedure

You can use one of the following two methods to bind an EIP to a pod.

Method 1: Bind an EIP to a pod in automatic mode

1. Log on to the Container Service for Kubernetes (ACK) console.
2. In the left-side navigation pane, click Serverless 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, click Workload.
5. Click the Deployments tab. On the tab that appears, click Create from Template, select a sample template or Custom, 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 cluster or a virtual node automatically assigns and binds an EIP to the pod.

   apiVersion: v1
   kind: Pod
   metadata:
     name: nginx
     annotations:
       "k8s.aliyun.com/eci-with-eip": "true"
   spec:
     containers:
     - image: registry-vpc.cn-hangzhou.aliyuncs.com/jovi/nginx:alpine
       imagePullPolicy: Always
       name: nginx
       ports:
       - containerPort: 80
         name: http
         protocol: TCP
     restartPolicy: OnFailure

   Note

   • You can use the annotation k8s.aliyun.com/eip-bandwidth to specify the bandwidth for the EIP. Default value: 5. Unit: Mbit/s.
   • You can also use the annotation k8s.aliyun.com/eip-common-bandwith-package-id to add an Elastic Compute Service (ECS) instance that has an EIP to an EIP bandwidth plan instance.
   • If you create a deployment, the system assigns an EIP to each pod in the deployment. Exercise caution when you perform this operation.
6. Click the Pods tab to view the pod status.
7. Find the pod that you want to manage and click Edit. The Edit YAML dialog box appears.
   Note The IP address of k8s.aliyun.com/allocated-eipAddress: 47.110.XX.XX in the YAML file is the public IP address of the EIP.
8. Enter http://IP address in a browser to visit the NGINX welcome page.

   In http://IP address, enter the IP address obtained from k8s.aliyun.com/allocated-eipAddress: 47.110.XX.XX of the YAML file.

   

   Note This method dynamically assigns an EIP to a pod, and the lifecycle of the EIP is the same as that of the pod. If you delete a pod, the EIP assigned to the pod is automatically deleted.

Method 2: Specify an EIP ID

1. Log on to the VPC console and purchase an EIP. For more information, see Apply for new EIPs.
   Note The EIP 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, click Serverless 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, click Workload.
6. Click the Deployments tab. On the tab that appears, click Create from Template, select a sample template or Custom, and then click Create.

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

   apiVersion: v1
   kind: Pod
   metadata:
     name: nginx
     annotations:
       "k8s.aliyun.com/eci-eip-instanceid": "<youreipInstanceId>"
   spec:
     containers:
     - image: registry-vpc.cn-hangzhou.aliyuncs.com/jovi/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.
7. Click the Pods tab to view the pod status.
8. Enter http://IP address in a browser to visit the NGINX welcome page.
   

   Note In http://IP address, enter the IP address of the EIP obtained in Step 1.