文档首页/ 云容器实例 CCI/ API参考/ 快速入门
更新时间：2026-02-05 GMT+08:00
查看PDF
分享

快速入门

概述

本文通过调用一系列云容器实例的API使用nginx镜像创建一个工作负载，介绍使用云容器实例API的基本流程。

其中，镜像直接使用开源镜像中心的nginx镜像，容器的资源规格为1vCPU、2GiB。

API的调用方法请参见如何调用API。

创建流程

  1. 调用创建Namespace接口创建命名空间。
  2. 调用创建Network接口创建网络，与VPC和子网关联。
  3. 调用创建Deployment接口创建nginx容器负载。

创建Nginx负载

  1. 调用创建Namespace接口创建命名空间。 

    {
  "apiVersion": "cci/v2",
  "kind": "Namespace",
  "metadata": {
    "name": "namespace-test"
  }
}

    您需要指定如下参数。

    • name：命名空间的名称。

  2. 调用创建Network接口创建网络，与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"
      }
    ]
  }
}

    您需要指定如下参数。

  3. 调用创建Deployment接口创建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负载创建完后，您可以在云容器实例控制台云容器实例控制台查看到负载。

相关文档