Vapor プロジェクトの開発に使えそうなツールの紹介

Tokyo Server-Side Swift Meetup #5 2016.12.19 多鹿豊

Transcript

1. Vapor プロジェクトの 開発に使えそうなツールの紹 介 Tokyo Server-Side Swift Meetup #5 2016.12.19 多鹿豊
2. 目次 ◦ 自己紹介 ◦ Vapor周辺ツールの紹介 □ gulp-vapor □ Flock, FlockVapor ◦ 所感
3. 目次 ◦ 自己紹介 ◦ Vapor周辺ツールの紹介 □ gulp-vapor □ Flock, FlockVapor ◦ 所感
4. 自己紹介（personal） ◦ 多鹿 豊 (Tajika Yutaka) ◦ @taji-taji □ Qiita, Github
5. 自己紹介（work） ◦ ウェルスタイル株式会社 □ 家族限定SNS「wellnote」を開発・運営 ◦ iOSエンジニア □ AWS, Python □ ちょっとGo, PHP, Rails
6. 目次 ◦ 自己紹介 ◦ Vapor周辺ツールの紹介 □ gulp-vapor □ Flock, FlockVapor ◦ 所感
7. Vapor A Web Framework For swift
8. Vapor概要 ◦ Swift製 Web Framework ◦ website, API, cloud project... https://github.com/vapor/vapor
9. gulp-vapor hot reload
10. gulp-vapor概要 ◦ Vapor用のgulpタスクを使用するためのgulpプ ラグイン ◦ Vaporのコードの編集を検知してhot-reloadし てくれる https://www.npmjs.com/package/gulp-vapor
11. gulp-vapor 導入前 1. vapor build コマンド 2. vapor run コマンド □ → localhost でプロジェクトのサーバー起動 3. ブラウザで動作確認 4. コード編集（保存） 5. vaporを殺す 6. 1に戻る
12. 導入してみる
13. セットアップ # gulpのインストール $ npm install -g gulp # プロジェクト直下でnpm init $ cd /path/to/your/vapor/project $ npm init # gulp-vaporをインストール $ npm install --save-dev gulp $ npm install --save-dev gulp-vapor
14. gulpfile.js 'use strict'; var gulp = require('gulp'); var vapor = require('gulp-vapor'); vapor.config.commands.build = 'vapor build'; gulp.task('vapor:start', vapor.start); gulp.task('vapor:reload', vapor.reload); gulp.task('watch', function() { var target = [ './Sources/**/*', './Resources/**/*' ]; gulp.watch(target, ['vapor:reload']); }); gulp.task('default', ['vapor:start', 'watch']);
15. gulp-vapor 導入後 1. gulp コマンド □ → localhost でプロジェクトのサーバー起動 2. ブラウザで動作確認 3. コード編集（保存） □ → gulp-vapor が保存を検知してbuild→reload 4. 2に戻る
16. gulp-vapor 導入後 最初に gulp コマンドを叩いてサーバーを起動 させれば、あとはコードを編集しているだけで 勝 手にビルドしなおしてサーバーをリロードし てくれる
17. gulp-vapor 導入後 ただし - 最初の1回は手動で vapor build してい ないといけない - ブラウザは手動でリロード
18. Flock, FlockVapor deploy
19. Flock概要 ◦ Swift製 ◦ Capistranoライクなデプロイツール ◦ Vapor, Kitura, Perfect, Zewo といった主要フ レームワークのデプロイに対応 https://github.com/jakeheis/Flock
20. 導入してみる
21. まずはプロジェクトにデ プロイ設定を
22. セットアップ # brewでインストール $ brew install jakeheis/repo/flock # Vaporプロジェクト直下で初期化 $ cd /path/to/your/project $ flock --init
23. セットアップ # brewでインストール $ brew install jakeheis/repo/flock # Vaporプロジェクト直下で初期化 $ cd /path/to/your/project $ flock --init • .flock/ • Flockfile • Config/deploy/ といったファイル・ディレクトリが作られ る
24. セットアップ { "dependencies" : [ { "url" : "https://github.com/jakeheis/Flock", "version": "0.1.1" }, { "url" : "https://github.com/jakeheis/VaporFlock", "version": "0.0.4" } ] } Config/deploy/FlockDependencies.json
25. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile
26. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile 共通の設定
27. セットアップ Config/deploy/Always.swift
28. セットアップ Config/deploy/Always.swift プロジェクト名 実行ファイル名 リポジトリURL Swiftバージョン
29. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile production環境 の設定
30. セットアップ Config/deploy/Production.swift
31. セットアップ Config/deploy/Production.swift # 環境変数にキーの場所を登録 $ export FLOCK_KEY=$HOME/.ssh/your-key-pair.pem
32. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile staging環境
33. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile # 環境を追加する $ flock --add-env <env>
34. デプロイ先の環境設定
35. セットアップ $ flock tools
36. セットアップ (flock tools) • デプロイに必要な依存ライブラリ・ツールをデプロイ先 サーバーにインストール • デプロイ先サーバーにswiftenvをインストールし、swiftenv でSwiftをインストールする
37. セットアップ (flock tools) • デプロイに必要な依存ライブラリ・ツールをデプロイ先 サーバーにインストール • デプロイ先サーバーにswiftenvをインストールし、swiftenv でSwiftをインストールする $ flock tools:dependencies $ flock tools:swift
38. • Nginxのインストールおよび設定をしておく セットアップ （デプロイ先） https://vapor.github.io/documentation/deploy/nginx.html
39. デプロイ
40. デプロイ $ flock deploy
41. デプロイ • gitからコードのclone • コードのbuild • デプロイした最新のコードがあるディレクトリにリンクを貼 る
42. デプロイ • gitからコードのclone • コードのbuild • デプロイした最新のコードがあるディレクトリにリンクを貼 る $ flock deploy:git $ flock tools:build $ flock tools:link
43. ここまでは Flockのドキュメントを見れば 分かる内容かも...
44. ハマったところ
45. 1. dependencies 2. executableName 3. 実行ユーザー
46. 1. dependencies
47. dependencies { "dependencies" : [ { "url" : "https://github.com/jakeheis/Flock", "version": "0.1.1" }, { "url" : "https://github.com/jakeheis/VaporFlock", "version": "0.0.4" } ] } Config/deploy/FlockDependencies.json
48. dependencies { "dependencies" : [ { "url" : "https://github.com/jakeheis/Flock", "version": "0.1.1" }, { "url" : "https://github.com/jakeheis/VaporFlock", "version": "0.0.3" } ] } Config/deploy/FlockDependencies.json
49. dependencies { "dependencies" : [ { "url" : "https://github.com/jakeheis/Flock", "version": "0.1.1" }, { "url" : "https://github.com/jakeheis/VaporFlock", "version": "0.0.3" } ] } Config/deploy/FlockDependencies.json
50. dependencies { "dependencies" : [ { "url" : "https://github.com/jakeheis/Flock", "version": "0.1.1" }, { "url" : "https://github.com/jakeheis/VaporFlock", "version": "0.0.3" } ] } Config/deploy/FlockDependencies.json VaporFlock 0.0.3 は Flock 0.0.x に依存しているため、 バージョンの食い違いが起こ る
51. 2. executableName
52. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile 共通の設定
53. Config/deploy/Always.swift Config/deploy/Always.swift
54. Config/deploy/Always.swift Config/deploy/Always.swift
55. Config/deploy/Always.swift Same as Config.projectName unless your project is divided into modules
56. Config/deploy/Always.swift
57. Config/deploy/Always.swift ◦ Vaporのプロジェクトはbuildすると App という 実行ファイルができる □ release buildの場合は .build/release/App が実行ファ イル ◦ 盲目的に Config.projectName と同じにしてハ マった
58. 3. 実行ユーザー
59. セットアップ import Flock import VaporFlock Flock.use(Flock.Tools) Flock.use(Flock.Deploy) Flock.use(Flock.Vapor) Flock.configure(.always, with: Always()) // Located at config/deploy/Always.swift Flock.configure(.env("production"), with: Production()) // Located at config/deploy/Production.swift Flock.configure(.env("staging"), with: Staging()) // Located at config/deploy/Staging.swift Flock.run() Flockfile production環境 の設定
60. Config/deploy /Production.swift Config/deploy/Production.swift
61. Config/deploy /Production.swift Config/deploy/Production.swift
62. Config/deploy /Production.swift ◦ 当初 vagrant で試していた時に vagrant ユー ザーを設定 ◦ → supervisor の installができず... apt-get -qq install supervisor E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission denied) E: Unable to lock the administration directory (/var/lib/dpkg/), are you root?
63. Config/deploy /Production.swift ◦ root ユーザーで実行させることにした □ →Flock作者のExampleプロジェクトでもrootになって いたが、若干気持ち悪さが残ったまま
64. 目次 ◦ 自己紹介 ◦ Vapor周辺ツールの紹介 □ gulp-vapor □ Flock, FlockVapor ◦ 所感
65. 所感 ◦ 周辺ツールも実用的になってくると　Server Side Swift がより身近に感じられる ◦ とはいえ、まだまだ安定しない部分も ◦ OSSに貢献できるチャンスでもある
66. ご清聴ありがとうございました