doc-exports/docs/cci/api-ref/cci_02_0011.html

Getting Started

Overview

You can call APIs to create a pod. An Nginx image is used as an example to show how you can create a pod.

The Nginx image is from the open-source image center, and the container uses 1 vCPU and 2 GiB of memory.

For details about how to call APIs, see Calling APIs.

Procedure

1. Call the API described in Creating a Namespace to create a namespace.
2. Call the API described in Creating a Network to create a network, and associate the network with a VPC and subnet.
3. Call the API described in Creating a Pod to create an Nginx pod.

Creating an Nginx Pod

1. Call the API described in Creating a Namespace to create a namespace.

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

   You must specify the following parameters:

   • name: namespace name.

2. Call the API described in Creating a Network to create a network, and associate the network with a VPC and subnet.

   {
     "apiVersion": "yangtse/v2",
     "kind": "Network",
     "metadata": {
       "annotations": {
         "yangtse.io/domain-id": "51ed88507a244b6eb36270c0250fcc96",
         "yangtse.io/project-id": "a81f079abca74e83b47af9a586048b24"
       },
       "name": "test-network",
       "namespace": "namespace-test"
     },
     "spec": {
       "networkType": "underlay_neutron",
       "securityGroups": [
         "470b6a8f-612e-4284-a788-c6900ac32fce"
       ],
       "subnets": [
         {
           "subnetID": "c6dd31e3-d217-4b31-bb60-eb30322c75b8"
         }
       ]
     }
   }

   You must specify the following parameters:

   • name: name of a network object.
   • securityGroups: security group ID, which can be obtained on the Security Groups page.
   • yangtse.io/domain-id: account ID, which can be obtained by following the procedure in Obtaining an Account ID.
   • yangtse.io/project-id: project ID, which can be obtained by following the procedure in Obtaining a Project ID.
   • subnetID: ID of the subnet in the VPC, which can be obtained on the VPC console or by calling the API for querying subnets.

3. Call the API described in Creating a Pod to create an Nginx pod.

   In this example, a pod whose name is nginx and specifications are set to 1 vCPU and 2 GiB of memory will be created from the open-source image nginx:stable-alpine-perl. After the API is called, CCI creates a container running nginx.

   {
     "apiVersion": "cci/v2",
     "kind": "Pod",
     "metadata": {
       "name": "nginx"
     },
     "spec": {
       "containers": [
         {
           "image": "nginx:stable-alpine-perl",
           "name": "container-0",
           "resources": {
             "limits": {
               "cpu": "1",
               "memory": "2Gi"
             },
             "requests": {
               "cpu": "1",
               "memory": "2Gi"
             }
           }
         }
       ],
       "imagePullSecrets": [
         {
           "name": "imagepull-secret"
         }
       ]
     }
   }

   You must specify the following parameters:

   • name: pod name
   • containers: container information
     • image: image used to create containers
     • name: container name
     • resources.limits: resource limits for a container. The resources used by a container cannot exceed the limits.
     • resources.requests: resources requested by a container

   After the pod is created, you can view it on the CCI console.