AWS宝典:如何在亚马逊EC2上部署API?

译文
开发 前端 Linux
对于刚接触AWS(亚马逊网络服务)的人来说,学习起来难度相当大。于是我们为读者整理出了若干条最佳实践,做成这篇简短教程。除了亚马逊EC2(弹性计算云)外,我们还会使用Ruby Grape这种微型框架来构建API接口,并使用Nginx代理系统来处理访问控制。

【51CTO精选译文】我们觉得亚马逊是一种用来运行API(应用编程接口)的出色平台,因为你可以全面控制应用程序堆栈。对于刚接触AWS(亚马逊网络服务)的人来说,学习起来难度相当大。于是我们为读者整理出了若干条***实践,做成这篇简短教程。除了亚马逊EC2(弹性计算云)外,我们还会使用Ruby Grape这种微型框架来构建API接口,并使用Nginx代理系统来处理访问控制。最棒的是,本教程中提到的所有一切都是完全免费的!

就该教程而言,你需要基于Ruby的运行中API和Thin服务器。要是没有这样一个API,你只要克隆示例软件库,如下所述(参阅“部署应用程序”部分)。

现在,我们将开始构建和配置亚马逊EC2实例。要是你已经有了EC2实例(无论是不是微型实例),就可以直接跳到下一步:准备部署的实例。

构建和配置EC2实例

首先不妨注册亚马逊弹性计算云(Amazon EC2)。就我们的要求而言,免费服务http://aws.amazon.com/free/就够用了,它可以满足所有的基本要求。一旦设立好了帐户,进入到AWS管理控制台下面的EC2仪表板,点击Launch Instance(启动实例)按钮。这会让你进入到一个弹出窗口,你可以在里面继续下一步:

•选择经典向导。

•选择AMI(Ubuntu Server 12.04.1 LTS 32位和微型实例),Instance Details(实例细节)的其他所有设置都不用改动,随它保持默认值。

•创建密钥对,并下载密钥对――这将是你用来与服务器之间建立SSH连接的密钥对,密钥对非常重要!

•为防火墙添加入站规则,源地址始终是0.0.0.0/0(HTTP、HTTPS、ALL ICMP和Ruby Thin服务器使用的TCP端口3000)。

准备部署的实例

现在,我们已让实例构建并运行起来,我们可以直接通过控制台来连接(Windows用户可以通过PuTTY来连接)。鼠标右击实例,连接实例,并选择Connect with a standalone SSH Client(使用独立的SSH客户端来连接)。

 

 

逐步完成下列步骤,在给出的实例中将用户名改成ubuntu(而不是root)。

 

 

完成这一步后,你就连接到了实例。我们还需要安装新的软件包。一些软件包需要root登录资料(凭证),所以你需要设置一个新的root密码:sudo passwd root。然后以root用户身份登录:su root。

现在已有了root登录资料,执行:

sudo apt-get update

使用exit命令切换回到普通用户,并安装所有的必需软件包:

•安装rvm、ruby和git需要的一些库:

sudo apt-get install build-essential git zlib1g-dev libssl-dev libreadline-gplv2-dev

imagemagick libxml2-dev libxslt1-dev openssl zlib1g libyaml-dev libxslt-dev autoconf libc6-

dev ncurses-dev automake libtool bison libpq-dev libpq5 libeditline-dev

sudo apt-get install libreadline6 libreadline6-dev

•安装git(在Linux上,而不是来自源文件):http://www.git-scm.com/book/en/Getting-Started-Installing-Git

•安装rvm:https://rvm.io/rvm/install/

•安装ruby

•rvm install 1.9.3

•rvm use 1.9.3 --default

部署应用程序

我们的示例Sentiment API位于Github上。试着克隆软件库:

git clone git@github.com:jerzyn/api-demo.git

你可以在这里再次审查构建和部署该应用程序方面的代码及教程:

http://www.3scale.net/2012/06/the-10-minute-api-up-running-3scale-grape-heroku-api-10-minutes/

还有这里:

http://www.3scale.net/2012/07/how-to-out-of-the-box-api-analytics/

要注意其中的变化(我们使用的只是v1,因为代理系统需要完成验证)。

现在你可以部署应用程序,只要运行命令:bundle install.

现在你可以开启Thin服务器:thin start.

想直接访问API(即没有任何安全或访问控制):your-public-dns:3000/v1/words/awesome.json(你可以在实例细节窗口中的AWS EC2仪表板>实例中找到你的公共DNS)。

 

 

如果还想使用Nginx,你需要创建一个弹性IP地址。在AWS EC2仪表板里面,在与实例相同的区域里面创建弹性IP,并将该IP与它关联起来(你没必要为弹性IP花一分钱,只要它与你同一区域里面的实例关联起来)。

 

 

选项:如果你想为亚马逊实例分配自定义域,就要做一件事:

•将A记录添加到域的DNS记录,以便将该域与你之前创建的那个弹性IP地址对应起来。你的域提供商应该会为你提供设置A记录(IPv4地址)的某种方式,或者它会为你提供编辑域名称服务器的方式。如果提供商不允许你直接设置A记录,找到一项DNS管理服务,在上面将你的域注册为一个区(zone),该服务就会在域提供商的管理面板你提供需要输入的名称服务器。然后,你可以为域添加A记录。一些可能的DNS管理服务包括ZoneEdit(基础版免费)和亚马逊route 53等。

至此,你的API已向世人开放。这既是好事又是坏事――说它是好事,是因为可以与人共享API;说它是坏事,是因为要是不实行速率限制(rate limit),几个应用程序就会耗尽你服务器的资源,而且你也不知道谁在使用你的API、API在如何使用。解决办法就是,为你的API添加一些管理功能。

借助3scale启用API管理功能

我们将充分利用使用方便的3scale API管理服务,而不是从事重复性工作,从头开始实行速率限制、访问控制和分析。注册获得免费的3scale帐户(http://www.3scale.net/),通过几个提供的链接,激活并登录进入到新实例。你***次登录时,可以选择这个选项:创建一些示例数据,那样你拥有之后用到的一些API密钥。下一步,你可能要浏览一下系统功能(可选),然后开始实施工作。

想立即获得一些结果,我们就要从开发过程中用到的沙盒代理系统开始入手。然后,我们还将配置Nginx代理系统,它可以扩展规模,以适应标准的生产部署环境。API代理系统的配置方面有一些说明文档,详见:https://support.3scale.net/howtos/api-configuration/nginx-proxy。想了解更高级的配置选项,可以参阅:https://support.3scale.net/howtos/api-configuration/nginx-proxy-advanced。

一旦你进入到了3scale帐户,在主仪表板屏幕上启动你的API,或者进入到API->选择Service ‘API’(服务API)->侧栏中的Integration(集成)->Proxy(代理)。

 

 

设好API后端部分的地址――这必须是个弹性IP地址,除非自定义域已设置好,包括http协议和端口3000。现在,你可以保存并启动沙盒代理系统,通过访问沙盒端点来测试API(在创建了一些应用程序登录资料后): http://sandbox-endpoint/v1/words/awesome.json?app_id=APP_ID&app_key=APP_KEY。其中,APP_ID和APP_KEY是你在***登录到3scale帐户后创建的其中一个示例应用程序的ID和密钥(如果你错过了帐户创建这一步,只要创建开发者帐户以及该帐户里面的应用程序)。

不用应用程序登录资料试一下,接下来使用不正确的登录资料试一下;然后一旦通过验证,在你定义的任何速率限制范围之内和之外再试一下。只有其表现让你满意,你才需要为Nginx下载配置文件。

注意:一旦遇到错误,就要检查你是否能直接访问API:your-public-dns:3000/v1/words/awesome.json。要是该API不可用,那么你就要检查AWS实例是否在运行、Thin服务器是否在该实例上运行。

部署Nginx代理系统以实现访问控制

为了简化这一步,我们建议你安装出色的OpenResty Web应用程序,它基本上捆绑了标准的Nginx核心以及几乎所有必要的第三方Nginx内置模块。

安装依赖项:sudo apt-get install libreadline-dev libncurses5-dev libpcre3-dev perl

编译和安装Nginx:

•cd ~

•sudo wget http://agentzh.org/misc/nginx/ngx_openresty-1.2.3.8.tar.gz

•sudo tar -zxvf ngx_openresty-1.2.3.8.tar.gz

•cd ngx_openresty-1.2.3.8/

•./configure --prefix=/opt/openresty --with-luajit --with-http_iconv_module -j2

•make

•sudo make install

现在,你可以从3scale代理页面下载Nginx配置文件了;在配置文件中,进行下列更改:

•编辑来自nginx下载的配置文件

•在第28行(上一行是更改服务器名称的信息),输入正确的域(你的弹性IP或自定义域名)

•在第78行,将路径改为指向与配置文件一同下载的.lua文件。

我们几乎大功告成了!***一个步骤是开启NGINX代理系统,让一些流量通过它。要是它还没有运行(切记:首先得开启那台Thin服务器),务必进入到EC2实例终端(你之前通过SSH连接的那个终端),然后现在开启它:

sudo /opt/openresty/nginx/sbin/nginx -p /opt/openresty/nginx/ -c /opt/openresty/nginx/conf/YOUR-CONFIG-FILE.conf

***一步将是验证流量正常通过,并通过了应有的验证。为此,访问:

http://your-public-dns/v1/words/awesome.json?app_id=APP_ID&app_key=APP_KEY

其中,APP_ID和APP_KEY是你想通过API调用来访问的那个应用程序的密钥和ID。一旦证实一切都正常运行,你就需要阻止公众通过端口3000对API后端部分进行访问,端口3000绕过了任何访问控制机制。

要是Nginx配置方面遇到了一些问题,或者需要介绍更详细的指南,我鼓励你阅读配置Nginx代理系统方面的这篇指南文章: https://support.3scale.net/howtos/api-configuration/nginx-proxy。你完全可以对你的API网关进行定制。如果你想深入探究3scale的系统配置(比如用法和API流量的监控),欢迎浏览“快速入门”指南(https://support.3scale.net/get-started/fast-track-integration)和实用指导(https://support.3scale.net/howtos/basics#manage-admins)。
 

英文:http://www.3scale.net/2013/02/quickstart-tutorial-on-how-to-deploy-an-api-on-amazon-ec2-for-amazon-web-services-aws-rookies/?utm_source=Outbrain&utm_campaign=AWS-Q3

责任编辑:林师授 来源: 51CTO
相关推荐

2014-08-26 11:07:15

技术周刊

2014-11-14 10:06:06

AWSEC2 Contain亚马逊

2013-06-03 09:24:34

公有云计算亚马逊EC2API

2018-02-23 15:15:31

UbuntuAnsibleAmazon EC2

2014-08-18 11:17:03

AWS EC2Salt Cloud

2017-12-02 12:42:57

AWSEC2

2012-03-09 15:30:26

亚马逊EC2云计算

2012-06-20 15:26:40

亚马逊EC2云计算

2009-03-30 17:25:17

Amazon亚马逊Eclipse

2012-11-15 09:30:59

亚马逊EC2云计算

2014-07-02 21:24:09

AWSAmazon EC2

2017-04-20 19:15:32

Linux服务器AWS EC2

2020-12-01 15:47:49

AWSEC2macOS

2011-04-25 09:06:55

亚马逊EC2

2009-12-14 15:34:53

2018-05-17 22:16:07

Amazon EC2Web服务

2015-08-21 17:47:38

Docker安全EC2容器服务

2012-10-17 13:41:02

亚马逊EC2OpenStackNimbula Dir

2011-05-04 15:36:01

亚马逊EC2

2009-07-02 19:28:00

云计算红帽Linux
点赞
收藏

51CTO技术栈公众号