先日公開した日本語解析 API(+α)を使用して日本語の文書校正を効率化してみるにて、
\n\nと色々なツールを試してみたので、そのまとめを残したいと思います。
\n\n雑ですがアイキャッチ画像に書き足してみました。
\nSlack に通知を飛ばすのは書くまでもなく、矢印が煩雑になるだけなので割愛しました。
やりたいことは目次に分割しているので、１つずつお話したいと思います。
\n大前提です。ちゃちゃっと作ってしまいます。
\nリポジトリの作成にはhubコマンドを使用しています。
cd /path/to/work\nmkdir repo-name && cd repo-name\necho '# Repo name' > README.md\ngit init\ngit add README.md\ngit commit -m 'initial commit'\nhub create\ngit push origin master\nhub browseついでに連携する各サービスのアカウントも作成しておきます。
\nhttps://{slackのチーム名}.slack.com/services/new
\nを開くと、各種サービスとの連携ができます。
Github の Slack integration を設定します。
\n特に詰まることはなく、画面に従えば問題なく設定できるかと思います。
Circle CI は、テストを走らせたりデプロイしたりする CI 系サービスです。 似たサービスとしてTravis CI、Werckerがありますが、
\nそれらは使ったことがあったので、今回は使ったこと無い Circle CI を使ってみました。
Circle CI にログインし、Github に登録したリポジトリを CI 対象として登録します。
\nそしてリポジトリに Circle CI を設定します。
\nドキュメントはこちらです。
YAML ファイルでも Ruby のバージョンを指定できるそうなのですが、.ruby-versionの方が汎用的かと思いそちらを使用しています。
git checkout -b feat/circle-ci\nrbenv local 2.2.2\ngit add .ruby-version\ngit commit -m 'Add .ruby-version'\necho 'gem \"rspec\"' >> Gemfile\nbundle install --path=vendor/bundle\ngit add Gemfile*\ngit commit -m 'Add rspec gem'\ngit push origin feat/circle-ci連携が完了していると、pull リクエストを作成した時に以下のようになると思います。
\n少し待って
\nとなればビルドに成功した、ということになります。
\n今後 Circle CI との連携を増やしていきますが、基本はこれです。
\nビルドに通らない場合はだいたいが設定ミスです。
ついでに Slack との連携も済ませておきます。
\nCode climate はコードの静的解析ツールです。
\n連携している Github のリポジトリ内のコードに静的解析をかけ、問題が有れば指摘してくれます。
\n対応している言語は Ruby, PHP, Python, js です。
Code climate にログインし、対象のリポジトリを有効にしておきます。
\n初回起動までが結構長いので、先にやっておくと良いです。
初回の分析が終わるとこのような画面になります。
\n1 ファイル D 評価取って急いで直した履歴は見なかったことにして下さい。
全ファイルが A、GPA が 4.0 なら指摘事項なし、という意味になります。
\n次に、Github の Pull request と連携させます。
\nまずGithub の Personal access tokensを開き、Code climate 用のアクセストークンを生成します。
\n名前は自分で分かる適当な名前、スコープはrepo:statusが選ばれていれば問題ないです。
生成されたトークンをコピーしておきます。
\nトークンが表示されている画面から 別画面に行くと２度とコピーできなくなる ので注意が必要です。
settings の中にある「Integrations」タブを開き、「GitHub Pull Requests」を選択します。
\nコピーしておいたアクセストークンを貼り付けて貼り付けて設定完了。
\nこれで Circle CI のように Pull request 時にコードのチェックがかかります。
と思ったのですが 、オープンソースのリポジトリは常にポーリングしているので PR 連携は提供してませんよ、とのこと。
\n\n\nNote: If you added your repository by clicking Add Open Source Repo, Code Climate will always check for new commits based a poll or when you manually trigger a refresh. We don’t yet support service hooks for these types of repositories.
\n
\n— GitHub Pull Request Integration
\n— How do I install Code Climate’s Github service hook?
ついでに Code climate も Slack と連携させます。
\nここまでの設定で、
\nは判定可能になりました。ついでなのでテストのカバレッジも出力してみたいと思います。
\nCode climate の settings を開き、「Test Coverage」を選択します。
\nドキュメントが出てくるので手順通りに進めます。
マニュアル内のCODECLIMATE_REPO_TOKEN=....となっている箇所を Circle CI 側にも指定する必要があるのでコピーして貼り付けます。
\nCircle CI のプロジェクト設定の、「Environment variables」に設定します。
Github にプルリクエストを作ってマージし、Code climate にカバレッジが出れば成功です。
\nさりげなく２重の丸に変わっているのがおしゃれでよいですね。
\nYAPC::Asia Tokyo 2015にてesa.ioの中の人の素敵なプレゼンをお聞きし、
\nプレゼン中に出てきたci-bundle-updateがとても良いと思いました。
これから毎日 bundle update しようぜ？
\nということで早速導入。
\n解説記事の内容でハマったところがあったので、あらためて記事として手順を残します。
\n\nこのように circle.yml の deployment section を変更します。
\n
\nhttps://github.com/masutaka/masutaka-29hours/commit/0ba9ef03348568baaa5cf271d4f6e41305f8fdfe
とありますが、ここでハマりました。
\n./script/deploy-circleci.shなんて無いぞ…？ Circle CI でのお決まりなのかな…？
\nと思いながらそのまま書いたら、案の定ビルドにコケました。なので以下のように修正
+ - |\n+ if [ -n \"${BUNDLE_UPDATE}\" ] ; then\n+ gem update bundler --no-document\n+ gem install circleci-bundle-update-pr\n+ circleci-bundle-update-pr CircleCI circleci@example.com\n+ fiこれでビルドが通るようになりました。 もう１個ハマりました。
\n\n\n環境変数 BUNDLE_UPDATE が指定されていたら、circleci-bundle-update-pr gem をインストールして、同コマンドを実行しています。この環境変数は後述するトリガーが設定してきます。
\n
とあったので、Circle CI 側にも環境変数の設定が必要なのか…？
\nと思って指定したらビルド通らなくなりました。
日本語読めよ という話なのですが、Circle CI 側にはこの環境変数の指定は不要です。
\n他は特に詰まることは無かったので、解説記事さまを呼んでいけば設定完了すると思います。 これで毎日 bundle update して何かアップデートがあれば PR が飛ぶようになりました。
\nちなみに、Ruby のプロジェクトだけでなく npm(Nodejs)や composer(PHP)など幅広く対応しているtachikoma.ioというサービスもあるようです。
\nしかし今回は Ruby のプロジェクトなので、tachikoma.io より Ruby に関して高機能な ci-bundle-update を使用しました。
tachikoma については別途 Node のプロジェクトで試している最中なので、また記事を書きます。
\nそういえば、npm の ci update は David ではなくshrinkwrap使わないんですかね…、bower にもshrinkwrap の機能が検討されているようなので、そちらも対応されたら対応するのかなー、なんて思っています。
全部設定すると Slack がだいぶ賑わってきます。
\n一人じゃんけん感はんぱねぇ…！
\n自分で Pull request 作ってマージしてブランチ消した途端 Slack の通知が
\nスポポポポッ ってなって 「うん、知ってる」 ってなる！ ！
意識高そうな感じでやってる感はすごく出るので、一人でも比較的モチベは保ちやすいかなと思います。
\nぼっち開発環境の第一弾、ひとまず完成です。