# 快速入门
#### 概述
本文通过调用一系列云容器实例的API使用nginx镜像创建一个工作负载，介绍使用云容器实例API的基本流程。
其中，镜像直接使用开源镜像中心的nginx镜像，容器的资源规格为1vCPU、2GiB。
API的调用方法请参见[如何调用API](https://support.huaweicloud.com/api-cci2/cci_02_0009.html)。
#### 创建流程
1. 调用[创建Namespace](https://support.huaweicloud.com/api-cci2/createNamespace.html)接口创建命名空间。
2. 调用[创建Network](https://support.huaweicloud.com/api-cci2/createNamespacedNetwork.html)接口创建网络，与VPC和子网关联。
3. 调用[创建Deployment](https://support.huaweicloud.com/api-cci2/createNamespacedDeployment.html)接口创建nginx容器负载。
 
#### 创建Nginx负载
1. 调用[创建Namespace](https://support.huaweicloud.com/api-cci2/createNamespace.html)接口创建命名空间。
   
   ```
   {
     "apiVersion": "cci/v2",
     "kind": "Namespace",
     "metadata": {
       "name": "namespace-test"
     }
   }
   ```
   您需要指定如下参数。
   - name：命名空间的名称。
   
   
   
   
2. 调用[创建Network](https://support.huaweicloud.com/api-cci2/createNamespacedNetwork.html)接口创建网络，与VPC与子网关联。
   
   ```
   {
     "apiVersion": "yangtse/v2",
     "kind": "Network",
     "metadata": {
       "annotations": {
         "yangtse.io/domain-id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
         "yangtse.io/project-id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
       },
       "name": "test-network",
       "namespace": "namespace-test"
     },
     "spec": {
       "networkType": "underlay_neutron",
       "securityGroups": [
         "xxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
       ],
       "subnets": [
         {
           "subnetID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
         }
       ]
     }
   }
   ```
   您需要指定如下参数。
   - name：网络对象的名称。
   
   - securityGroups：安全组ID，您可以在[安全组控制台](https://console.huaweicloud.com/vpc/#/vpc/vpcmanager/securitygroups)查看。
   
   - yangtse.io/domain-id：账号ID，获取方法请参见[获取账号ID](https://support.huaweicloud.com/api-cci2/cci_02_1002.html)。
   
   - yangtse.io/project-id：项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cci2/cci_02_1001.html)。
   
   - subnetID：VPC内子网的ID，您可以在[虚拟私有云控制台](https://console.huaweicloud.com/vpc/#/vpc/vpcmanager/vpcs)中查询，也可以通过[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)API查询。
   
   
   
   
3. 调用[创建Deployment](https://support.huaweicloud.com/api-cci2/createNamespacedDeployment.html)接口创建nginx容器负载。
   
   负载名称为nginx，使用开源镜像中心的nginx:stable-alpine-perl镜像，容器的资源规格为1核CPU、2G内存。调用接口后，云容器实例会创建一个运行nginx的容器。
   ```
   {
     "kind": "Deployment",
     "apiVersion": "cci/v2",
     "metadata": {
       "name": "nginx",
       "labels": {
         "app": "nginx"
       }
     },
     "spec": {
       "replicas": 1,
       "selector": {
         "matchLabels": {
           "app": "nginx"
         }
       },
       "template": {
         "metadata": {
           "labels": {
             "app": "nginx"
           }
         },
         "spec": {
           "containers": [
             {
               "name": "container-0",
               "image": "library/nginx:stable-alpine-perl",
               "resources": {
                 "limits": {
                   "cpu": "1",
                   "memory": "2Gi"
                 },
                 "requests": {
                   "cpu": "1",
                   "memory": "2Gi"
                 }
               }
             }
           ],
           "imagePullSecrets": [
             {
               "name": "imagepull-secret"
             }
           ]
         }
       }
     }
   }
   ```
   您需要指定如下参数。
   - name：Deployment的名称。
   
   - replicas：Pod的数量，即Deployment下有几个Pod。
   
   - selector.matchLabels：Deployment使用哪些标签选择Pod，例如这里设置的标签app=nginx，当Pod有这个标签时，就会被Deployment选中管理。
   
   - template：Pod的模板，定义Pod的各种配置和规格。
     - metadata.labels：Pod的标签。
     
     - spec.containers：Pod中容器的定义。
       - image：创建容器使用的镜像。
       
       - resources.limits：容器使用资源的大小限制，即容器使用的资源不能超过这个限制。
       
       - resources.requests：容器申请使用资源的大小。
        
      
   
   
   Nginx负载创建完后，您可以在[云容器实例控制台](https://console.huaweicloud.com/cci/#/app/dashboard)云容器实例控制台查看到负载。
   ![](https://support.huaweicloud.com/api-cci2/zh-cn_image_0000001912080649.png)