Alibaba Cloud Toolkit 使用指南

Alibaba Cloud Toolkit for Eclipse（下文简称 Cloud Toolkit）是一个免费的 IDE 插件，帮助阿里云用户更高效的使用阿里云。

您只需注册或使用一个已有的阿里云账号，即可免费下载 Cloud Toolkit。下载完成后，您可以将该插件安装到 Eclipse 中。

当您在本地完成应用程序的开发、调试及测试后，通过该插件即可轻松将应用程序部署到阿里云。目前支持将应用部署到 ECS、EDAS 或容器服务 Kubernetes。

本文档将向您介绍如何在 Eclipse 中安装 Cloud Toolkit，并使用 Cloud Toolkit 快速部署一个应用。

安装 Cloud Toolkit

• 方式一：在 Eclipse Marketplace 中下载安装
• 方式二：通过 Clout Toolkit 官方地址安装

获取 Access Key ID 和 Access Key Secret

• 使用阿里云主账号获取 Access Key ID 和 Access Key Secret
• 使用 RAM 子账号获取 Access Key ID 和 Access Key Secret

设置 Access Key ID 和 Access Key Secret

部署应用

• 将应用部署到 ECS
• 将应用部署到 EDAS
• 将应用部署到 CS Kubernetes

安装 Cloud Toolkit

有两种安装 Cloud Toolkit 方式，在 Eclipse Marketplace 中下载安装和直接通过 Cloud Toolkit 的官方地址安装。

准备工作

安装前，需要完成以下准备工作：

• 下载并安装 JDK 1.8 或更高版本。
• 下载并安装适用于 Java EE 开发人员的 Eclipse IDE、4.5.0（代号：Mars）或更高版本。

在 Eclipse Marketplace 中下载安装

1. 启动 Eclipse。

2. 在菜单栏中选择 Help > Eclipse Marketplace...。

3. 在 Eclipse Marketplace 对话框中 Find 右侧的文本框中输入 Alibaba Cloud Toolkit，然后回车。

   

4. 在搜索结果中 Alibaba Cloud Toolkit 右下角单击 Install。

   

5. 按照 Eclipse 安装页面的提示，完成后续安装步骤。

通过 Clout Toolkit 官方地址安装

如果您无法连接 Eclipse Market 服务器，请选择这种安装方式。

1. 启动 Eclipse。

2. 在菜单栏中选择 Help > Install New Software。

3. 在 Available Software 对话框的 Work with 文本框中输入 Cloud Toolkit for Eclipse 的 URL http://toolkit.aliyun.com/eclipse/。

4. 在下面的列表区域中勾选需要的组件 Alibaba Cloud Toolkit Core 和 Alibaba Cloud Toolkit Deployment Tools，并在下方 Details 区域中不勾选 Connect all update sites during install to find required software.

   

5. 配置完成后，单击 Next，Eclipse 开始安装插件，并显示安装进度。

   

6. 按照 Eclipse 安装页面的提示，完成后续安装步骤。

结果确认

插件安装成功后，重启 Eclipse，您可以在工具栏看到 Alibaba Cloud Toolkit 的图标。

获取 Access Key ID 和 Access Key Secret

您本地的应用部署到云端时，都需要使用阿里云上的资源、应用。所以在部署前，需要设置您的阿里云账号信息，以保证拥有使用、管理相关资源、应用的权限。

使用阿里云主账号获取 Access Key ID 和 Access Key Secret

1. 进入阿里云控制台首页。

   阿里云将检测您的登录状态。

   • 如果已登录，则进入控制台首页。
   • 如果未登录，则跳转到登录夜间，输入阿里云账号、密码，然后单击登录。登录后，跳转到控制台首页。

2. 将光标滑动（非单击）到控制页页面右上角您的头像上，在弹出的下拉菜单中单击 accesskeys。

   

3. 在安全提示对话框中单击继续使用 AccessKey。

   

4. 在安全信息管理页面用户 AccessKey区域单击显示，在手机验证对话框中单击点击获取，然后输入验证码。

5. 记录该账号的 Access Key ID 和 Access Key Secret。

使用 RAM 子账号获取 Access Key ID 和 Access Key Secret

1. 进入 RAM 子账号登录页面，输入您的子账号，单击下一步，然后再输入密码，单击登录。

2. 将光标滑动（非单击）到控制页页面右上角您的头像上，在弹出的下拉菜单中单击 AccessKey 管理。

3. 在安全信息管理页面用户 AccessKey区域右侧单击创建 AccessKey。

   注意：如果您当前子账号的“创建 AccessKey” 置灰不可用，请使用主账号授权该子账号 RAM 的操作权限。具体操作请参考给子账号授权。

4. 在新建用户 AccessKey对话框中 AccessKey 详情右侧单击下拉箭头。

5. 记录当前账号的 Access Key ID 和 Access Key Secret。

设置 Access Key ID 和 Access Key Secret

1. 启动 Eclipse。

2. 在工具栏单击 Alibaba Cloud Toolkit 图标，在下拉菜单中单击 Alibaba Cloud Preference...。

3. 在 Preference (Filtered) 对话框的左侧导航栏中单击 Accounts。

4. 在 Accounts 界面中设置 Access Key ID 和 Access Key Secret，然后单击确定。

   • 如果您已有阿里云账号，单击 Get existing AK/SK，参考文档获取 Access Key ID 和 Access Key Secret。
   • 如果您还没有阿里云账号，在 Accounts 界面中单击单击 Sign up，进入阿里云账号注册页面，注册账号。注册完成后按照上述方式获取 Access Key ID 和 Access Key Secret。

   

Cloud Toolkit 目前提供了 3 种部署应用的途径：

• 将应用部署到 ECS
• 将应用部署到 EDAS
• 将应用部署到 CS Kubernetes

部署应用

将应用部署到 ECS

前提条件

您已经在要部署应用的地域下购买了 ECS。

操作步骤

1. 在 Eclipse

2. 右键单击您的应用工程名，在弹出的下拉菜单中选择 Alibaba Cloud > Deploy to ECS...。

3. 在 Deployment Configuration 对话框设置部署参数然后单击 Deploy。

   

   部署参数说明：

   • Deploy File：Maven Build 或 Upload File。

   • Target Deploy ECS：在下拉列表中选择地域，然后在地域中选择要部署的 ECS 实例。

   • Deploy Location ：输入在 ECS 上部署路径，如 /root/tomcat/webapps。

   • Commond：输入应用启动命令，如 sh /root/restart.sh。

将应用部署到 EDAS

目前支持将应用通过 WAR/JAR 包部署。

1. 在 Eclipse 界面左侧的 Package Explorer 中右键单击您的应用工程名，在弹出的下拉菜单中选择 Alibaba Cloud > Deploy to EDAS...。

2. 在 EDAS Deployment Configuration 对话框根据您的实际需求选择应用的 Region、Namespace、Application 和 Group，设置部署方式，然后单击 Deploy。

   说明：如果您还没有在 EDAS 上创建应用，在对话框右上角单击 Create application On EDAS console，跳转到 EDAS 控制台创建应用。创建应用的步骤请参考创建普通应用。

   应用信息说明：

   • Region：应用所在地域。
   • Namespace：应用所在命名空间。
   • Application：应用名称。
   • Group：应用分组。

   

部署应用到容器服务 Kubernetes

1. 设置用于打包本地镜像的 Docker 环境。

   1. 在 Eclipse 工具栏单击 Alibaba Cloud Toolkit 图标，在下拉菜单中单击 Alibaba Cloud Preference...。

   2. 在 Preference (Filtered) 对话框的左侧导航栏中单击 Docker。

   3. 在 Docker 界面中设置可连接的 Docker 环境，包括本地和远程两种方式，然后单击 OK。

      • 本地 Docker 环境：如果您本地的机器为 Mac 或 Linux 操作系统，勾选 Unix Socket，然后单击 Browse...，选择本地的 Docker 安装目录。
      • 远程 Docker 环境：如果您本地的机器为 Windows 操作系统，或者想使用一个可连接的远程 Docker 环境，勾选 Tcp Connection，在 URI 右侧的文本框里输入远端的 Docker 环境的 URI（包括 IP 地址和端口）。

      

1. 在 Eclipse 界面左侧的 Package Explorer 中右键单击您的 Docker 应用工程名，在弹出的下拉菜单中选择 Alibaba Cloud > Deploy to CS Kubernetes...。

2. 在 Select a package method 对话框选择本地应用程序的 Context Directory 和 Dockerfile (通常会根据您本地的应用工程自动识别并设置)，然后单击 Next。

   您可以根据您的需要决定是否勾选 Use maven build 使用 Maven 构建应用工程。

   

3. 在 Select a Repository 对话框选择容器镜像服务的地域、命名空间和镜像仓库，然后单击 Next。

   如果您还没有镜像仓库，在对话框右上角单击Create a new repository跳转到容器镜像仓库创建镜像仓库。创建步骤请参考容器镜像仓库文档。

   

4. 在 Deploy Project to CS Kubernetes 对话框选择容器服务 Kubernetes 的Clusters（集群）、Namespace（命名空间）和 Deployment（部署），然后单击 Finish。

   如果您还没有创建容器服务 Kubernetes 的 Deployment，在对话框右上角单击 Create a new Kubernetes deployment，跳转到容器服务-Kubernetes 控制台创建 Deployment。创建步骤请参考容器服务 Kubernetes 版文档。

   

结果验证

部署开始后，Eclipse 的 Console 区域会打印部署日志。您可以根据日志信息检查部署结果。

如果您在使用 Cloud Toolkit 过程中有任何疑问，欢迎您扫描下面的二维码加入钉钉群进行反馈。