AWS寶典：如何在亞馬遜EC2上部署API？
譯文【51CTO精選譯文】我們覺得亞馬遜是一種用來運行API（應(yīng)用編程接口）的出色平臺，因為你可以全面控制應(yīng)用程序堆棧。對于剛接觸AWS（亞馬遜網(wǎng)絡(luò)服務(wù)）的人來說，學(xué)習(xí)起來難度相當(dāng)大。于是我們?yōu)樽x者整理出了若干條***實踐，做成這篇簡短教程。除了亞馬遜EC2（彈性計算云）外，我們還會使用Ruby Grape這種微型框架來構(gòu)建API接口，并使用Nginx代理系統(tǒng)來處理訪問控制。最棒的是，本教程中提到的所有一切都是完全免費的！
就該教程而言，你需要基于Ruby的運行中API和Thin服務(wù)器。要是沒有這樣一個API，你只要克隆示例軟件庫，如下所述（參閱“部署應(yīng)用程序”部分）。
現(xiàn)在，我們將開始構(gòu)建和配置亞馬遜EC2實例。要是你已經(jīng)有了EC2實例（無論是不是微型實例），就可以直接跳到下一步：準(zhǔn)備部署的實例。
構(gòu)建和配置EC2實例
首先不妨注冊亞馬遜彈性計算云（Amazon EC2）。就我們的要求而言，免費服務(wù)http://aws.amazon.com/free/就夠用了，它可以滿足所有的基本要求。一旦設(shè)立好了帳戶，進入到AWS管理控制臺下面的EC2儀表板，點擊Launch Instance（啟動實例）按鈕。這會讓你進入到一個彈出窗口，你可以在里面繼續(xù)下一步：
•選擇經(jīng)典向?qū)А?/p>
•選擇AMI（Ubuntu Server 12.04.1 LTS 32位和微型實例），Instance Details（實例細節(jié)）的其他所有設(shè)置都不用改動，隨它保持默認(rèn)值。
•創(chuàng)建密鑰對，并下載密鑰對――這將是你用來與服務(wù)器之間建立SSH連接的密鑰對，密鑰對非常重要！
•為防火墻添加入站規(guī)則，源地址始終是0.0.0.0/0（HTTP、HTTPS、ALL ICMP和Ruby Thin服務(wù)器使用的TCP端口3000）。
準(zhǔn)備部署的實例
現(xiàn)在，我們已讓實例構(gòu)建并運行起來，我們可以直接通過控制臺來連接（Windows用戶可以通過PuTTY來連接）。鼠標(biāo)右擊實例，連接實例，并選擇Connect with a standalone SSH Client（使用獨立的SSH客戶端來連接）。
逐步完成下列步驟，在給出的實例中將用戶名改成ubuntu（而不是root）。
完成這一步后，你就連接到了實例。我們還需要安裝新的軟件包。一些軟件包需要root登錄資料（憑證），所以你需要設(shè)置一個新的root密碼：sudo passwd root。然后以root用戶身份登錄：su root。
現(xiàn)在已有了root登錄資料，執(zhí)行：
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
部署應(yīng)用程序
我們的示例Sentiment API位于Github上。試著克隆軟件庫：
git clone git@github.com:jerzyn/api-demo.git
你可以在這里再次審查構(gòu)建和部署該應(yīng)用程序方面的代碼及教程：
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，因為代理系統(tǒng)需要完成驗證）。
現(xiàn)在你可以部署應(yīng)用程序，只要運行命令：bundle install.
現(xiàn)在你可以開啟Thin服務(wù)器：thin start.
想直接訪問API（即沒有任何安全或訪問控制）：your-public-dns:3000/v1/words/awesome.json（你可以在實例細節(jié)窗口中的AWS EC2儀表板>實例中找到你的公共DNS）。
如果還想使用Nginx，你需要創(chuàng)建一個彈性IP地址。在AWS EC2儀表板里面，在與實例相同的區(qū)域里面創(chuàng)建彈性IP，并將該IP與它關(guān)聯(lián)起來（你沒必要為彈性IP花一分錢，只要它與你同一區(qū)域里面的實例關(guān)聯(lián)起來）。
選項：如果你想為亞馬遜實例分配自定義域，就要做一件事：
•將A記錄添加到域的DNS記錄，以便將該域與你之前創(chuàng)建的那個彈性IP地址對應(yīng)起來。你的域提供商應(yīng)該會為你提供設(shè)置A記錄（IPv4地址）的某種方式，或者它會為你提供編輯域名稱服務(wù)器的方式。如果提供商不允許你直接設(shè)置A記錄，找到一項DNS管理服務(wù)，在上面將你的域注冊為一個區(qū)（zone），該服務(wù)就會在域提供商的管理面板你提供需要輸入的名稱服務(wù)器。然后，你可以為域添加A記錄。一些可能的DNS管理服務(wù)包括ZoneEdit（基礎(chǔ)版免費）和亞馬遜route 53等。
至此，你的API已向世人開放。這既是好事又是壞事――說它是好事，是因為可以與人共享API；說它是壞事，是因為要是不實行速率限制（rate limit），幾個應(yīng)用程序就會耗盡你服務(wù)器的資源，而且你也不知道誰在使用你的API、API在如何使用。解決辦法就是，為你的API添加一些管理功能。
借助3scale啟用API管理功能
我們將充分利用使用方便的3scale API管理服務(wù)，而不是從事重復(fù)性工作，從頭開始實行速率限制、訪問控制和分析。注冊獲得免費的3scale帳戶（http://www.3scale.net/），通過幾個提供的鏈接，激活并登錄進入到新實例。你***次登錄時，可以選擇這個選項：創(chuàng)建一些示例數(shù)據(jù)，那樣你擁有之后用到的一些API密鑰。下一步，你可能要瀏覽一下系統(tǒng)功能（可選），然后開始實施工作。
想立即獲得一些結(jié)果，我們就要從開發(fā)過程中用到的沙盒代理系統(tǒng)開始入手。然后，我們還將配置Nginx代理系統(tǒng)，它可以擴展規(guī)模，以適應(yīng)標(biāo)準(zhǔn)的生產(chǎn)部署環(huán)境。API代理系統(tǒng)的配置方面有一些說明文檔，詳見：https://support.3scale.net/howtos/api-configuration/nginx-proxy。想了解更高級的配置選項，可以參閱：https://support.3scale.net/howtos/api-configuration/nginx-proxy-advanced。
一旦你進入到了3scale帳戶，在主儀表板屏幕上啟動你的API，或者進入到API->選擇Service ‘API’（服務(wù)API）->側(cè)欄中的Integration（集成）->Proxy（代理）。
設(shè)好API后端部分的地址――這必須是個彈性IP地址，除非自定義域已設(shè)置好，包括http協(xié)議和端口3000。現(xiàn)在，你可以保存并啟動沙盒代理系統(tǒng)，通過訪問沙盒端點來測試API（在創(chuàng)建了一些應(yīng)用程序登錄資料后）： http://sandbox-endpoint/v1/words/awesome.json?app_id=APP_ID&app_key=APP_KEY。其中，APP_ID和APP_KEY是你在***登錄到3scale帳戶后創(chuàng)建的其中一個示例應(yīng)用程序的ID和密鑰（如果你錯過了帳戶創(chuàng)建這一步，只要創(chuàng)建開發(fā)者帳戶以及該帳戶里面的應(yīng)用程序）。
不用應(yīng)用程序登錄資料試一下，接下來使用不正確的登錄資料試一下；然后一旦通過驗證，在你定義的任何速率限制范圍之內(nèi)和之外再試一下。只有其表現(xiàn)讓你滿意，你才需要為Nginx下載配置文件。
注意：一旦遇到錯誤，就要檢查你是否能直接訪問API：your-public-dns:3000/v1/words/awesome.json。要是該API不可用，那么你就要檢查AWS實例是否在運行、Thin服務(wù)器是否在該實例上運行。
部署Nginx代理系統(tǒng)以實現(xiàn)訪問控制
為了簡化這一步，我們建議你安裝出色的OpenResty Web應(yīng)用程序，它基本上捆綁了標(biāo)準(zhǔn)的Nginx核心以及幾乎所有必要的第三方Nginx內(nèi)置模塊。
安裝依賴項：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
現(xiàn)在，你可以從3scale代理頁面下載Nginx配置文件了；在配置文件中，進行下列更改：
•編輯來自nginx下載的配置文件
•在第28行（上一行是更改服務(wù)器名稱的信息），輸入正確的域（你的彈性IP或自定義域名）
•在第78行，將路徑改為指向與配置文件一同下載的.lua文件。
我們幾乎大功告成了！***一個步驟是開啟NGINX代理系統(tǒng)，讓一些流量通過它。要是它還沒有運行（切記：首先得開啟那臺Thin服務(wù)器），務(wù)必進入到EC2實例終端（你之前通過SSH連接的那個終端），然后現(xiàn)在開啟它：
sudo /opt/openresty/nginx/sbin/nginx -p /opt/openresty/nginx/ -c /opt/openresty/nginx/conf/YOUR-CONFIG-FILE.conf
***一步將是驗證流量正常通過，并通過了應(yīng)有的驗證。為此，訪問：
http://your-public-dns/v1/words/awesome.json?app_id=APP_ID&app_key=APP_KEY
其中，APP_ID和APP_KEY是你想通過API調(diào)用來訪問的那個應(yīng)用程序的密鑰和ID。一旦證實一切都正常運行，你就需要阻止公眾通過端口3000對API后端部分進行訪問，端口3000繞過了任何訪問控制機制。
要是Nginx配置方面遇到了一些問題，或者需要介紹更詳細的指南，我鼓勵你閱讀配置Nginx代理系統(tǒng)方面的這篇指南文章： https://support.3scale.net/howtos/api-configuration/nginx-proxy。你完全可以對你的API網(wǎng)關(guān)進行定制。如果你想深入探究3scale的系統(tǒng)配置（比如用法和API流量的監(jiān)控），歡迎瀏覽“快速入門”指南（https://support.3scale.net/get-started/fast-track-integration）和實用指導(dǎo)（https://support.3scale.net/howtos/basics#manage-admins）。
