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

背景信息

Alibaba Cloud Toolkit(下文简称 Cloud Toolkit)是一个免费的IDE插件,帮助阿里云用户更高效的使用阿里云。

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

当您在本地完成应用程序的开发、调试及测试后,通过该插件即可轻松将应用程序部署到阿里云。关于Cloud Toolkit的详细信息,请参见Alibaba Cloud Toolkit

安装Cloud Toolkit

您可以在如下路径下获取软件安装包。
有两种安装Cloud Toolkit方式:在Eclipse Marketplace中下载安装和直接通过Cloud Toolkit的官方地址安装。
  • 在Eclipse Marketplace中下载安装。
    1. 启动Eclipse。
    2. 在菜单栏中选择Help > Eclipse Marketplace...
    3. Eclipse Marketplace对话框中Find右侧的文本框中输入Alibaba Cloud Toolkit,然后回车。
    4. 单击搜索结果中Alibaba Cloud Toolkit右下角的installed安装插件1
    5. 按照Eclipse安装页面的提示,完成后续安装步骤。
  • 通过Cloud Toolkit的官方地址安装。
    说明 如果您无法连接Eclipse Market服务器,请选择这种安装方式。
    1. 启动Eclipse。
    2. 在菜单栏中选择Help > Install New Software
    3. Available Software对话框的Work with文本框输入Cloud Toolkit for Eclipse的URLhttp://toolkit.aliyun.com/eclipse/
    4. 在下面的列表区域中勾选需要的组件 Alibaba Cloud Toolkit CoreAlibaba Cloud Toolkit Deployment Tools,并在下方的Details区域中不勾选Connect all update sites during install to find required software.安装插件2
    5. 配置完成后,单击Next,Eclipse开始安装插件,并显示安装进度。安装插件3
    6. 按照Eclipse安装页面的提示,完成后续安装步骤。

预期结果:

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

获取Access Key ID和Access Key Secret

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

  • 使用阿里云主账号获取Access Key ID和Access Key Secret
    1. 登录容器服务管理控制台
    2. 将光标滑动(非单击)到控制台页面右上角您的头像上,在弹出的下拉菜单中单击accesskeys获取ak
    3. 安全提示对话框中单击继续使用AccessKey安全提示
    4. 安全信息管理页面,用户 AccessKey区域右侧单击创建AccessKey,在手机验证对话框中单击点击获取后输入验证码。
    5. 记录该账号的Access Key ID和Access Key Secret。
  • 使用RAM子账号获取Access Key ID和Access Key Secret
    1. 登录RAM子账号登录页面,输入您的子账号,单击下一步,再输入密码,单击登录
    2. 将光标滑动(非单击)到控制台页面右上角您的头像上,在弹出的下拉菜单中单击AccessKey管理ak管理
    3. 安全信息管理页面,用户 AccessKey区域右侧单击创建AccessKey
      说明
      • 如果您当前子账号的创建AccessKey置灰不可用,请使用主账号对该子账号授权,可参见使用子账号
      • 新建用户AccessKey对话框中,单击AccessKey详情右侧下拉箭头,记录当前子账号的AccessKeyIDAccessKeySecret
      • 这是用户AccessKey可供下载的唯一机会,请及时保存。

设置Access Key ID和Access Key Secret

  1. 启动Eclipse。
  2. 在工具栏单击Alibaba Cloud Toolkit图标,在下拉菜单中单击Alibaba Cloud Preference...
  3. Preference (Filtered)对话框的左侧导航栏中单击Accounts
  4. Accounts区域设置Access Key IDAccess Key Secret,然后单击OK
    获取ak密钥
    说明
    • 如果您已有阿里云账号,单击Get existing AK/SK, 参见文档获取Access Key IDAccess Key Secret
    • 如果您没有阿里云账号,单击Sign up,进入阿里云账号注册页面,注册账号。注册完成后按照上述方式获取Access Key IDAccess Key Secret

部署应用

  1. 您已经完成部署前准备工作。
  2. 设置用于打包本地镜像的Docker环境。
    1. 在Eclipse工具栏单击Alibaba Cloud Toolkit, 在下拉菜单中单击Alibaba Cloud Preference...
    2. Preference (Filtered)对话框的左侧导航栏中单击Docker
    3. Docker界面中设置可连接的Docker环境,包括本地和远程两种方式。
      • 本地Docker环境
        • 如果您本地为Mac或Linux操作系统,勾选Unix Socket后单击Browse...,选择本地的Docker安装目录。
        • 如果您本地为Windows操作系统,勾选Tcp Connection后在URI右侧文档框输入本地Docker的URI,如http://127.0.0.1:2375
      • 远程Docker环境
        勾选Tcp Connection后在URI右侧文档框输入远端Docker环境的URI(包括IP地址和端口),如http://127.0.0.1:2375 ,并确保远程主机的HTTP服务开启。远程docker环境
    4. 配置然完成后单击OK
  3. 在Eclipse界面左侧的Package Explorer中右键单击您的Docker应用工程名,在弹出的下拉菜单中选择Alibaba Cloud > Deploy to CS Kubernetes...
  4. Select a package method对话框选择本地应用程序的Context DirectoryDockerfile(通常会根据您本地的应用工程自动识别并设置 ),然后单击Next
    说明 您可以根据您的需要决定是否勾选Use maven build使用Maven构建应用工程。
    选择路径
  5. Select a Repository对话框选择容器镜像服务的地域,命令空间和镜像仓库,然后单击Next
    说明 如果您还没有镜像仓库,在对话框右上角单击Create a new repository跳转到容器镜像仓库创建镜像仓库。创建步骤可参见容器镜像服务文档。
    镜像仓库
  6. Deploy Project to CS Kubernetes对话框选择容器服务Kubernetes的ClusterNamespaceDeployment,然后单击Finish
    说明
    • 如果您还没有创建容器服务Kubernetes的Deployment,在对话框右上角单击Create a new Kubernetes deployment,跳转到容器服务管理控制台创建Deployment。创建步骤可参见容器服务 Kubernetes 版文档。
    • Alibaba Cloud Toolkit目前只支持以更新方式部署您的应用,需要您预先在控制台手动创建一个部署(Deployment),然后基于该部署将镜像替换为您的镜像。
    创建完成

预期结果:

部署开始后,Eclipse的Console区域会打印部署日志,您可以根据日志信息检查部署结果。 更多信息请参见使用 Eclipse 部署应用到容器服务 Kubernetes
说明 如果您在使用Cloud Toolkit过程中有任何疑问,欢迎您扫描下面的二维码加入钉钉群进行反馈。Cloud Toolkit二维码