创建并管理环境

操作场景

环境是用于组件部署和运行的计算（如云容器引擎 CCE、弹性云服务器 ECS等）、网络（如弹性负载均衡 ELB、弹性IP EIP等）和中间件（如分布式缓存 DCS、云数据库 RDS等）等基础资源的集合。ServiceStage把多种基础资源组合为一个环境，如：开发环境、测试环境、预生产环境和生产环境。按环境维度来管理资源、部署组件，可以减少具体基础资源运维管理的复杂性。

下面介绍如何调用创建环境API创建环境，再调用根据环境ID修改环境资源API为环境添加其他需要的资源，最后调用根据环境ID获取环境详细信息API根据环境ID查询环境详细信息。

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

前提条件

• 已调用获取用户Token获取IAM用户的Token，并将token值设置为环境变量：export Token={token}。
• 已获取ServiceStage的终端节点，详细信息请参见地区和终端节点，并用于替换以下操作步骤示例中的{servicestage_endpoint}。

操作步骤

1. 调用创建环境API创建环境，请求示例如下：

   curl -k -H "Content-Type:application/json;charset=utf8" -H "X-Auth-Token:$Token" -X POST "https://{servicestage_endpoint}/v3/{project_id}/cas/environments" -d ' 
   {
       "name": "env-Kubernetes",
       "description": "test environment",
       "enterprise_project_id": "0",
       "charge_mode": "provided",
       "vpc_id": "081c539d-ed09-43b0-81d7-a87603e528b7",
       "labels": [
           {
               "key": "testKey",
               "value": "testValue"
           }
       ],
       "deploy_mode": "container"
   }'

   返回结果：

   {
       "id": "9cd33350-5d7f-46ec-ba6d-40ed793f0eb7",
       "name": "env-Kubernetes",
       "description": "test environment",
       "creator": "test_user",
       "enterprise_project_id": "0",
       "vpc_id": "081c539d-ed09-43b0-81d7-a87603e528b7",
       "deploy_mode": "container",
       "vm_cluster_size": 50,
       "labels": [
           {
               "key": "testKey",
               "value": "testValue"
           }
       ],
       "create_time": 1689564968283,
       "update_time": 1689564968283,
       "resources": []
   }

   记录返回结果中加粗显示的环境ID，用于替换后续示例中的{environment_id}。

2. 调用根据环境ID修改环境资源API为环境添加资源。
   根据您已有的资源和需求，可以将和环境相同VPC下的计算、网络、中间件等多种类型的资源添加到环境中。请求示例如下：

   curl -k -H "Content-Type:application/json;charset=utf8" -H "X-Auth-Token:$Token" -X PUT "https://{servicestage_endpoint}/v3/{project_id}/cas/environments/{environment_id}/resources" -d ' 
   {
       "resources": [
           {
               "id": "d2917177-3436-4e53-a5bc-706c3529e0e7",
               "name": "elb-pu6a",
               "type": "elb"
           }
       ]
   }'

   返回结果：

   {
       "resources": [
           {
               "id": "d2917177-3436-4e53-a5bc-706c3529e0e7",
               "type": "elb",
               "name": "elb-pu6a"
           }
       ]
   }

3. 调用根据环境ID获取环境详细信息API根据环境ID查询环境详细信息，请求示例如下：

   curl -k -H "Content-Type:application/json;charset=utf8" -H "X-Auth-Token:$Token" -X GET "https://{servicestage_endpoint}/v3/{project_id}/cas/environments/{environment_id}"

   返回结果：

   {
       "id": "9cd33350-5d7f-46ec-ba6d-40ed793f0eb7",
       "name": "env-Kubernetes",
       "description": "test environment",
       "creator": "test_user",
       "enterprise_project_id": "0",
       "vpc_id": "081c539d-ed09-43b0-81d7-a87603e528b7",
       "deploy_mode": "container",
       "vm_cluster_size": 50,
       "labels": [
           {
               "key": "testKey",
               "value": "testValue"
           }
       ],
       "create_time": 1689564968283,
       "update_time": 1689574181240,
       "resources": [
           {
               "id": "d2917177-3436-4e53-a5bc-706c3529e0e7",
               "type": "elb",
               "name": "elb-pu6a"
           }
       ]
   }