開発フローで見る
現場を支えるツールたち
#asucon
2017/04/14

開発現場のツール
(c) 2017 @shin1x1 / @kaz_29

基本の流れ
(c) 2017 @shin1x1 / @kaz_29

基本の流れ
検証環境
ソースコード
開発環境
リポジトリ
CI
本番環境
(c) 2017 @shin1x1 / @kaz_29

ソースコード
リポジトリ

ソースコードリポジトリ
(c) 2017 @shin1x1 / @kaz_29

GitHub
• デファクトスタンダード
• 連携サービスが豊富
=> CI, Heroku, Notification ...
• PR、コメント、レビュー
• $7/月で private repo 無制限
(c) 2017 @shin1x1 / @kaz_29

Git ブランチ戦略
• git-flow
• GitHub Flow
• GitHub Flow + 特定ブランチ追加
(c) 2017 @shin1x1 / @kaz_29

push
add-feature
PR, merge
staging
master
deploy
PR, merge
production
deploy
deploy

push
feature/name
PR, merge
staging
develop
deploy
PR, merge
production
master
deploy

WIP PR
• まずブランチを切る（feature/hoge）
• 空コミットして、push
• master への PR を作る
• コードを書き始める
(c) 2017 @shin1x1 / @kaz_29

実装中を示す
実装する目的や実装案を整理
実装中でもチームで共有できる

開発環境

開発環境
(c) 2017 @shin1x1 / @kaz_29

開発環境
• Web アプリケーション開発環境
• Mac + Vagrant / Docker for Mac
• IDE（JetBrains社 IDE: PhpStorm）
(c) 2017 @shin1x1 / @kaz_29

Vagrant / Docker
• プロジェクト専用の独立した環境
• どこでも同じ環境を再現
• 自動構築
(c) 2017 @shin1x1 / @kaz_29

Vagrant or Docker
• Vagrant は、完全に独立した環境
• Docker は、構築が簡単 / 起動も速い
• CI や検証、本番環境との共有
• Docker でダメなら、Vagrant
(c) 2017 @shin1x1 / @kaz_29

コードフォーマッタ
• コードフォーマットへの適応を検査、整形
=> 人がやらない、ツールにやらせる！
• インデント、ブレース位置、doc コメント等
• IDE / PHP_CodeSniffer / xxfmt
• git pre-commit hook で実行 / CI で実行
(c) 2017 @shin1x1 / @kaz_29

Zeplin
• デザインの指示書の共有サービス
=> Scketchのデータを取り込める
• デザイナ以外はScketchのライセンス不要
• 画面上にコメントを張れる
• Slackへの通知
• スタイルガイドのコードが生成される
(c) 2017 @shin1x1 / @kaz_29

Zeplin
(c) 2017 @shin1x1 / @kaz_29

CI 環境

CI 環境
(c) 2017 @shin1x1 / @kaz_29

CI 環境
• CircleCI / Jenkins / Travis
• GitHub への push, merge で実行
• CI タスクがエラーなら、PR をマージしない
• デプロイ（CD）も兼ねることが多い
(c) 2017 @shin1x1 / @kaz_29

CI で実行するタスク
• コードフォーマットチェック
• テスト実行（オールテスト）
• コード静的解析
• 脆弱性診断（VAddy、Vuls など）
(c) 2017 @shin1x1 / @kaz_29

CircleCI
• Docker 対応が便利
=> Docker で動けば、何でも ok
=> エラーが発生してもローカルで再現できる
• SSH できるのが良い
• 1 コンテナ無料なので利用しやすい
(c) 2017 @shin1x1 / @kaz_29

検証環境

検証環境
(c) 2017 @shin1x1 / @kaz_29

検証環境
• 簡単/安価に構築したい
=> HerokuなどのPaaSを利用
• 本番環境に近い環境で試験したい
=> 本番環境のサブセット的な構成
=> Ansibleなどでプロビジョニング
(c) 2017 @shin1x1 / @kaz_29

Heroku
• PaaS なので環境構築が楽、メンテも不要
• git push だけでデプロイ
• 豊富なアドオン
• GitHub との連携が楽
(c) 2017 @shin1x1 / @kaz_29

本番環境のサブセット
• できるだけ本番環境に近い環境で検証できる
=> 割切り、コストとのバランスも重要
• 環境構築は全環境で共通
=> 設定を環境ごとに用意
=> 継続的にテストされる
(c) 2017 @shin1x1 / @kaz_29

本番環境

本番環境
(c) 2017 @shin1x1 / @kaz_29

プロビジョニング
• Ansible
• エージェントレス
• YAML で書くので習得が簡単
• 開発環境 ∼ 検証環境 ∼ 本番環境すべて共通
=> 設定を環境ごとに用意
(c) 2017 @shin1x1 / @kaz_29

[宣伝]
2017/2/17 刊行
唯一の公式ロゴ入り
(2017/2/27出版時点)
(c) 2017 @shin1x1 / @kaz_29

デプロイ
• CIサーバー/開発環境からデプロイ
• デプロイツールで自動化
=> Capistrano, Ansible …
• 専用ブランチへのマージで自動実行
=> 固定 IP 縛りがあるなら Jenkins
• Hubotで手動実行
=> Slackへの書込みで実行
(c) 2017 @shin1x1 / @kaz_29

Ansistrano
• Ansible role
• Capistrano ライクなデプロイ
current -> releases/20170409123456
releases/
20170407100000/
20170409091001/
20170409123456/
shared/
• Jenkins から実行
(c) 2017 @shin1x1 / @kaz_29

デプロイ: 秘匿情報の反映
• APIキーなど
• Heroku: 環境変数を外部から入れる
• デプロイ環境に手動で設置
=> バージョン管理対象外にする
• ansible-vault で暗号化
(c) 2017 @shin1x1 / @kaz_29

運用、監視
• サービス系
Mackerel / CloudWatch / New Relic
• 自前
Zabbix / Nagios / Cacti
=> 管理が結構大変…
• 通知は Slack へ
(c) 2017 @shin1x1 / @kaz_29

Mackerel
• 導入が簡単
• APIが豊富
=> 外部との連携がしやすい
• 独自メトリックの追加も簡単
• 通知の種類が豊富
=> Slackにグラフ付きで通知されるのが便利
(c) 2017 @shin1x1 / @kaz_29

運用、監視
• UptimeRobot（HTTP外形監視）
• Rollbar（エラートラッキング）
• Azure OMS
=> ログ収集 + 解析
• 通知は Slack へ
(c) 2017 @shin1x1 / @kaz_29

Rollbar
• エラートラッキングサービス
• エラーや例外の収集、レポート
• HTTP で送るだけ（多くの言語に対応）
• 無料枠あり
(c) 2017 @shin1x1 / @kaz_29

運用、監視(スマフォアプリ)
• Crashlytics(Crash Report収集)
• Flurry(アプリ解析)
• DeployGate(ベータ版配布)
=> 公式のベータ版配付機能とはすみ分け
(c) 2017 @shin1x1 / @kaz_29

全ての通知を集約
(c) 2017 @shin1x1 / @kaz_29

Command
自動テスト
実⾏
Command
Push
実⾏
Story
更新通知
⾃動更新
Configuration
Slash
APIリファレンス
Command
自動生成
Deploy
API実行
配布
監視
ログ収集
クラッシュログ・イベント・エラー収集

まとめ

まとめ
• ツールにできることは、ツールに任せる
• 自動で動く状況を作る
• ツールで開発の流れを知る
(c) 2017 @shin1x1 / @kaz_29

まとめ
http://php-genba.shin1x1.com/