如何将 Parse 服务器迁移到 Heroku 或 AWS

做者：AppCoda，原文连接，原文日期：2016-04-16
译者：Crystal Sun；校对：numbbbbb；定稿：Channe

我以前写过这篇文章 Migrating a parse database to a self-host MongoDB instance，在此次的春季辅导教程中，咱们看一下如何将 parse 服务器迁移到 Heroku 或 Amazon Web Service。

对于还不了解 Parse 之死的人来讲，这意味着服务器（处理数据、与数据库互动、发送接收请求等待）须要迁移到其余地方了。Parse，后端即服务（BaaS），为开发者提供服务器和数据库的服务。然而，Parse 已在一月份关闭，官方建议，在 2017 年 1 月 28 日完全中止服务以前，请迁移 Parse 应用。Parse 官方建议你先迁移数据库，而后在迁移服务器。本教程假定你已经完成了数据库的迁移，正如咱们在上篇教程第一部分中所作的。

幸运的是，parse-server（GitHub 项目，由 Facebook 开源，『伟大的』 Parse 统治者）能够部署在大部分的云服务上。在本节教程里，咱们会讲述如何将 parse-server 部署到Salesforce 旗下知名的云服务供应商 Heroku。在本篇文章的最后部分，咱们会演示如何部署到 Amazon Web Services（AWS）上，世界上不少知名的 App 都在使用 AWS 的服务。

准备开始

首先到 Heroku.com 网站注册一个账号。为了演示 demo，我选择了免费方案。你根据本身的须要，选择合适的方案，好比付费方案。你能够在这里看到全部的付费方案。

部署到 Heroku 有两种方法可供选择。第一种是点击 Deploy to Heroku 按钮，而后出现一步接一步的提示流程，由于 Parse 已经在 Heroku 的服务器上设置过 parse-server 了，对非 JavaScript 程序员来讲，这多是最简单的方法了。若是你熟悉 git 和命令行，请使用克隆应用而后用命令行完成。话虽如此，可是你不能一生都避免使用命令行。无论你选择那种方式，都会涉及到命令行的。

方法 1：使用 Heroku 按钮

点击上面的按钮，建立一个新的 heroku 应用，你会看到相似下方图片的界面：

设置向导出现，让你输入应用名称（所有小写且不容许有空格）。

接下来，选择 runtime 选项。若是你住在美国，选择 United States（美国），其余地方，选择 Europe（欧洲）。runtime 选项，就是你但愿你的应用部署在哪一个地方。考虑到性能和速度，最好将应用服务器部署在离你较近的地方。

接下来更新配置，填写 Parse 帐户里对应的密钥（或者生成新的密钥，若是你不是迁移现存应用的话，这点之后再说）。安装路径为 /parse。

当你填完全部的字段后，点击 deploy 按钮，暂时先空着 MongoLab（也就作 mLab）开发。

可能须要你输入你的信用卡。

方法 2：克隆 Heroku 应用

parse-server 是开源项目，能够在 GitHub 上下载。若是你选择的是命令行而不是点击 Heroku 按钮，那么继续下方的操做。开始前，先打开终端（Terminal），使用下方的命令来克隆应用：

bash
cd ~
cd Desktop
 
git clone https://github.com/ParsePlatform/parse-server-example.git
git add .
git init
git commit -m "Initial Commit"

如今，你已经成功地将 parse-server 克隆到桌面了。

修改数据库的 URI

无论你在上面选择了哪一个方式，如今你的应用在必定程度上已经设置过了。若是你使用是方法 1，你须要在你电脑里复制一份本地代码副本，首先用下列命令行（也会将 App 克隆到电脑桌面）。

注意：下方的选项适用于选择了方法 1 的人

bash
$ heroku login 
 
$ cd ~/Desktop
$ heroku git:clone -a your-app-name
$ cd your-app-name
 
$ git add .
$ git commit -am "make it better"
$ git push heroku master

登陆后，须要输入认证（以后会详细说明，不过如今只须要输入 Heroku 账号的邮箱和密码，密码不会出如今屏幕上）。

如今，打开你最喜欢的文本编辑器（我比较喜欢 Sublime Text），打开新克隆的库（repository）（对于新手来讲，你能够直接将整个文件夹拖到 sublime text 图标上，而后 sublime text 会自动打开文件，或者使用顶部菜单的 File -> Open）。

如今，咱们须要打开 index.js 文件，修改 API 变量。注意第 14-23 行。

从第 14 行开始，咱们须要修改 databaseURL 参数。使用在本教程第一部分生成的路径来替换参数。我会使用下面的 url，不过你必须用你本身的 url 来替换。

mongodb://admin:mypassword@ds017678.mlab.com:17678/appcoda-test

接下来，咱们须要填写 appId 和 masterKey 参数。若是你是在迁移一个已经存在的应用，到 parse.com 上找到对应的数据。若是这是你第一次使用 parse-server 建立一个新工程，你能够生成随机的字母数字密钥。

在 parse.com 网站上登陆你的 Parse 账号，找到 Settings（设置），选择 Security & Keys。复制粘贴你的 Application ID（复制这个应用，不要复制成其余应用的）和 Master Key。下面的图片可供你参考（个人密钥出于安全考虑遮挡）。

注意：若是你选的是方法 1，那已经设置了你的密钥，你能够直接跳过这一步。即便如此，我仍是建议你看一下，这样你能对 parse-server 的工做机制有更深刻的理解。

在 index.js 文件里替换上你刚刚复制来的新密钥，你也能够添加 clientKey 做为一个参数，从 Parse 中获取。

最后，记住保存你的操做，快捷键 Command+S（Mac 电脑上）。

若是你不是迁移应用，那么使用随机生成器（例如 random.org 或其余相似的东西）来生成字母数字密钥。

接下来，部署 Heroku。

将 Parse 服务器部署到 Heroku

首先在电脑上安装 Heroku 工具条，从连接中能够找到官方安装指南。安装完成后，在终端（Terminal）中输入下列命令行：

bash
heroku login

接下来输入登陆 Heroku 信息，注意当你输入密码的时候，密码不会出如今屏幕上。

若是你选择的是方法 1，就没有必要用下面的命令行建立一个 Heroku 应用了。若是你选择的是方法 2，确保输入下列命令行来建立一个 Heroku 应用。

bash
heroku create

Heroku 会给你建立一个应用，如今提交修改内容，代码以下：

bash
git add .
git init
git commit -m "Updated api config"
git push heroku master

如今，你已经成功部署了 Heroku！若是你遇到任何错误，请在下方的评论栏中留言，我将尽力帮助你。

设置 Heroku 的环境变量

接下来，咱们须要设置 Heroku 的环境变量，回到终端（Terminal），输入下列命令（使用你的 MongoDB 实例中的 URI，咱们以前介绍过）。

bash
heroku config:set DATABASE_URI=mongodb://admin:mypassword@ds017678.mlab.com:17678/appcoda-test

回到 Heroku 网页上，点击你的应用，在 Settings tab 页下，点击 reveal config variables。

如今你应该能够看到 Heroku 的 config Variables 里有了 database URI。

恭喜你！你的 parse-server 已经成功地部署到了 Heroku。惟一的问题是：尚未链接到你的 iOS 应用上。

定位 Parse 服务器的 URL

为了可以将你的应用链接到新的 parse-server，首先要从 Heroku 应用设置里定位托管地址（hosting url）。

回到 index.js ，找到第 27 行，注意找 moutPath 变量是 /parse。

这个变量表示 parse 在 Heroku 服务器上的地址。目前来讲，地址是 /parse。因此，能够在 yourapp.herokuapp.com/parse（改为你本身的域名） 中访问 parse-server。

设置 iOS 应用

如今，咱们已经正确地配置和部署了服务器，是时候来设置 iOS 应用设置选项了，让 iOS 应用链接到新的 parse 服务器上。

在 Xcode 里，打开应用，选择 appdelegate.swift 文件，删除你之前的 app key 和 client key（而后写上你本身的密钥和服务器的 url）。

把下面这段代码删掉：

Parse.setApplicationId(“xxxxxxxxxxxxxxxxxxxxxxxx”, clientKey: “xxxxxxxxxxxxxxxxxxxxxxxx”)

替换成：

let config = ParseClientConfiguration(block: {
   (ParseMutableClientConfiguration) -> Void in
   ParseMutableClientConfiguration.applicationId = "xxxxxxxxxxxxxxxxxxxxxxxx";
   ParseMutableClientConfiguration.clientKey = "xxxxxxxxxxxxxxxxxxxxxxxx";
   ParseMutableClientConfiguration.server = "xxxxxxxxxxxxxxxxxxxxxxxx.com/parse";
});
 
Parse.initializeWithConfiguration(config);

完成操做后，点击 Run 按钮，测试一下应用。正常状况下应用会和迁移之前同样运行。若是你使用云代码，可能须要修改一下代码，来适应新的 parse 服务器环境。咱们会在下一个教程中涉及这个话题。另外，在下一个教程里，咱们还会介绍在服务器里托管 Parse 的 dashboard。不过如今而言，你能够继续使用 parse.com 的 dashboard，直到官方完全关闭服务，也就是 2017 年的一月。

恭喜！你已经成功地在 Heroku 上部署了 parse-server。

将 Parse 服务器部署到 AWS

注意：若是你已经将 parse-server 部署到了 Heroku 上，那么就不须要再部署到 AWS 上了，毕竟你的服务器只能使用一个云服务。这部分主要是用来参考。若是你不想使用 Heroku，想使用 AWS，能够继续阅读下面的章节。我会假设你已经阅读过上面 Heroku 部分的教程内容，若是出现一样的设置内容，我不会赘述。

Amazon Web Services（AWS）是全球知名的云服务提供商，为科技界许多知名的大型公司提供云服务。实际上，不少大型科技公司都在使用 AWS 的服务，例如苹果公司的 iCloud，Hulu，AirBnb，Lyft，Adobe，Slack （这些都是国外知名的科技公司）等等，这些只是使用 AWS 云存储服务的众多公司中一小部分。

那么，为何我先介绍 Heroku 呢？不一样于 AWS 的是，Heroku 更容易设置。对于大部分的设置，你能够直接进行无需输入帐单信息。AWS 则不同，设置方法比较复杂。为了演示如何部署到 AWS 上，咱们将使用另一个部署按钮和设置向导，来让全部的工做简单流畅。

再次强调一下，若是你已经将应用部署到了 Heroku，并且对 Heroku 的服务比较满意，你能够直接跳过这部分了。然而，若是你对如何部署到 AWS 上感兴趣，那么让咱们开始吧！

第一件事，到 AWS 上注册一个 AWS 账号，须要提供你的付款信息，这样才能使用免费方案。

完成后，点击下方的按钮，建立一个新的 AWS 应用，AWS 提供一组云服务工具，每一个工具都有本身的独特的功能，在本节教程中，咱们使用 Elastic Beanstalk（和 Elastic Cloud Compute Engine 或简称 EC2 紧密相关）。

什么是 Elastic Beanstalk ？
根据 Amazon 上的简介，Elastic Beanstalk 是一个易于使用的，用于部署和扩展网页应用和服务，适用的语言有 Java、.NET、PHP、Node.js、Python、Ruby、Go、Docker，例如 Apache、Nginx、Passenger 和 IIS。

是否是很炫酷？或许吧，总而言之，咱们将使用这个服务来设置和运行咱们的 parse 服务器。若是你想了解更多有关 Elastic Beanstalk 的信息，请参考官方网页。

点击按钮后，会出现一个增长应用名称的界面，以下图。

下一步，确保你的设置以下图，而后继续。

在接下来的界面里使用正确的密钥上传 parse 设置，parse 装在 /parse 下。

如今，点击 upload and deploy 按钮，完成最后一步。不出意外应用已经正确设置在 AWS 上了。

当你设置 iOS 应用时，确保你已经定位了 AWS 的 URL，能够在 elastic beanstalk 里找到（以下图）。

恭喜！你成功将 parse 服务器部署到了 AWS 上！剩下须要作的事情就是用适当的密钥和新的服务器 url 来设置 iOS 应用（后缀 /parse）。

结束

在本节教程中，咱们深刻了解了部署 parse 服务器的过程，估计如今你对部署过程已经掌握的比较牢固了。

注意，有些细节本文没有讨论。若是你使用的是云代码，你可能须要作一些改动才能正常运行。另外，你可能还须要一个 Parse dashboard 的替代品。幸运的是，Parse 团队已经将 dashboard 开源了，并提供了详尽的云代码更新指南。在以后的教程中，咱们会详细讨论这些内容。不过如今，你首先要将应用部署到 Heroku 或 AWS 上！

你以为本教程怎么样？请留下评论，分享你的想法。

本文由 SwiftGG 翻译组翻译，已经得到做者翻译受权，最新文章请访问 http://swift.gg。