快速入门

概述

通过快速入门可以学习到ServiceStage中三个核心概念：环境、应用、组件。

• 环境是把计算资源（如云容器引擎CCE）、网络资源（如弹性负载均衡ELB、弹性IP等）和中间件（如分布式缓存DCS、RDS、微服务引擎CSE等）组合而成，部署应用和组件时需要选择环境进行部署，选择后会自动加载此环境所包含的资源。
• 应用是一个功能相对完备的业务系统，由一个或多个特性相关的组件组成。比如：典型的ERP系统就是一个应用，它一般由会计、财务、生产控制、物流、采购、分销、库存等模块组成，这些模块之间相互有紧密的联系，每个模块就是一个组件。
• 组件是组成应用的某个业务特性实现，如上面的ERP系统举例。在微服务应用场景下，每个组件都有独立的软件包，可独立部署运行，部署的组件称为一个组件实例，一个组件也可以有多个组件实例形成一个集群来保障应用和组件的高可靠性。针对应用的组件实例进行启停、部署（升级组件版本配置）、回退/回滚、伸缩、查看日志、查看事件、设置访问方式、设置阈值告警等运维操作。

本文示例讲解如何搭建环境、创建应用、创建并部署组件、确认部署结果、访问应用、应用运维，供您体验ServiceStage的基本功能。

前提条件

1. 创建一个虚拟私有网络VPC，请参考创建虚拟私有云和子网，使用默认参数配置进行创建。
2. 创建一个CCE集群,

   集群中至少包含1个规格为8vCPUs、16GB内存或者2个规格为4vCPUs、8GB内存的ECS节点，并且绑定弹性IP。

3. 创建用于存储软件包的桶，请参考创建桶。
4. 创建不开启安全认证的微服务引擎，请参考创建微服务引擎。
5. 本示例提供了一个微服务demo，会在本地进行编译构建打包，需要本地机器环境安装了Java JDK和Maven，并且能够访问Maven中央库。

   安装后本地打开cmd命令，执行mvn -v命令能查到相关的版本信息，说明安装成功。如下所示，本示例使用Maven 3.6.3和JDK 1.8.0版本 ：

   Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
   ……
   Java version: 1.8.0_201,……

准备软件包

1. 下载微服务demo源码到本地并解压。
2. 在项目根目录下（例如：D:\servicecomb-samples-master\servicecomb-samples-master\ServiceComb-SpringMVC），打开cmd命令，执行mvn clean package命令，对Java项目进行编译打包。

   D:\servicecomb-samples-master\servicecomb-samples-master\ServiceComb-SpringMVC>mvn clean package
   ……
   [INFO] --- maven-jar-plugin:2.6:jar (default-jar) @ servicecomb ---
   [INFO] Building jar: D:\servicecomb-samples-master\servicecomb-samples-master\ServiceComb-SpringMVC\target\servicecomb-0.0.1-SNAPSHOT.jar
   [INFO]
   [INFO] --- spring-boot-maven-plugin:1.5.9.RELEASE:repackage (default) @ servicecomb ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   ……

   编译成功后，会在项目根目录下的target子目录（例如：D:\servicecomb-samples-master\servicecomb-samples-master\ServiceComb-SpringMVC\target）下生成servicecomb-0.0.1-SNAPSHOT.jar软件包，并显示“BUILD SUCCESS”。

3. 将生成的servicecomb-0.0.1-SNAPSHOT.jar软件包上传到已创建的OBS桶中备用。

   上传软件包，请参考《对象存储服务用户指南》的“上传文件”章节。

创建组织

1. 登录ServiceStage控制台。
2. 选择“部署源管理 > 组织管理”。
3. 单击“创建组织”，在弹出的页面中填写“组织名称”。
4. 单击“确定”。

创建环境

1. 登录ServiceStage控制台。
2. 选择“环境管理 > 创建环境”，参照下表设置环境信息。

   参数	参数说明
   环境名称	输入环境名称（例如：test-env）。
   *企业项目	设置企业项目。 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 创建企业项目后可以使用。
   虚拟私有云(VPC)	选择前提条件中已准备好的虚拟私有云VPC。 说明： 环境创建完成后，不支持修改VPC。
   环境类型	选择Kubernetes。

3. 单击“立即创建”，进入环境详情页面。
4. 在“资源配置”下左侧列表，选择“计算”资源类型下的“云容器引擎 CCE”，单击“立即绑定”。
5. 在弹出的对话框中，选择前提条件中已创建的CCE集群资源，单击“确定”。
6. 在“资源配置”下左侧列表，选择“中间件”资源类型下的“微服务引擎 CSE”，单击“纳管资源”。
7. 在弹出的对话框中，勾选前提条件中已创建的CSE资源，单击“确定”。

新建应用

1. 登录ServiceStage控制台。
2. 选择“应用管理 > 创建应用”。
3. 输入“应用名称”，例如：test-servicestage。选择企业项目。
4. 单击“确定”，完成应用创建。

创建并部署组件

1. 登录ServiceStage控制台。
2. 单击“应用管理”，进入应用列表。
3. 选择新建应用时创建的应用名称（例如：test-servicestage），单击“操作”列“新增组件”。
4. 在“基本信息”区域，参考下表设置必填组件基本信息，其余参数保持默认。

   参数	说明
   组件名称	输入组件名称（例如：test-cse）。
   所属环境	选择创建环境时创建的环境（例如test-env）。

5. 在“组件包”区域，参考下表设置必填组件包参数，其余参数保持默认。

   参数	说明
   技术栈	组件技术栈类型选择Java。
   上传方式	单击“选择软件包”，选择准备软件包时上传的软件包servicecomb-0.0.1-SNAPSHOT.jar。

6. 在“构建”区域，参考下表设置必填构建参数，其余参数保持默认。

   参数	说明
   组织	组织用于管理组件构建生成的镜像。 选择创建组织时创建的组织名称。
   构建环境	选择“使用当前环境构建”，使用组件所属的部署环境中的CCE集群进行镜像构建。 当前环境CCE集群的master节点和node节点的CPU架构必须保持一致，否则会导致组件构建失败。

7. 单击“下一步”。
8. “资源”区域，参数设置保持默认。
9. “访问方式”区域，参数设置保持默认。
10. “时区”区域，参数设置保持默认。
11. 在“高级设置”区域，展开“高级设置 > 微服务引擎”。
    1. 单击“绑定微服务引擎”。
    2. 选择当前环境下已纳管的微服务引擎。
    3. 单击“确定”。

12. 单击“创建并部署”，部署组件。

确认部署结果

1. 登录ServiceStage控制台。
2. 选择“微服务引擎 > 微服务目录”。
3. 在微服务引擎下拉列表选择部署了组件的微服务引擎。
4. 在“全部应用”下拉列表中选择springmvc应用。

   如果存在已部署的servicecombspringmvc微服务，且微服务实例数为2，则部署成功。

   

访问应用

1. 登录ServiceStage控制台。
2. 单击“应用管理”，进入应用列表。
3. 单击新建应用时创建的应用名称（例如：test-servicestage），进入“应用概览”页。
4. 在“组件列表”区域，单击创建并部署组件时创建的组件名称（例如：test-cse），进入组件“概览”页。
5. 单击“访问方式”。
6. 单击“TCP/UDP路由配置”区域的“添加服务”，参考下表设置参数。

   参数	参数说明
   服务名称	使用默认。
   访问方式	选择“公网访问”。
   访问类型	选择“弹性IP”。
   服务亲和	保持默认。
   端口映射	协议：选择“TCP”。 容器端口：输入8080。 访问端口：选择“自动生成”。

7. 单击“确定”，生成访问地址。
8. 单击“访问地址”列下的访问地址，访问应用。
   返回如下结果：

   {"message":"Not Found"}

9. 在浏览器地址栏输入http://7生成的访问地址/rest/helloworld?name=ServiceStage，再次访问应用。

   可以返回如下结果：

   "ServiceStage"

应用运维

1. 登录ServiceStage控制台。
2. 单击“应用管理”。
3. 单击新建应用时创建的应用名称（例如：test-servicestage），进入应用“概览”页。
4. 在“组件列表”区域，单击创建并部署组件时创建的组件名称（例如：test-cse），进入组件“概览”页，可以进行运维操作。