autotrailingslash は Goa v3 のプラグインで、末尾スラッシュのついた HTTP リクエストをハンドリングできるようにします。 Goa v3 は、v3.13.0 でデフォルトの HTTP ルーターを chi に切り替えました。この変更により、末尾にスラッシュが付いているリクエストが v3.12.4 以前と同じようには処理されなくなりました。このプラグインは以前の httptreemux のような動作を再現します。 github.com プラグインの有効化 プラグインを有効にするには、下記のように autotrailingslash を import します。 import ( _ "github.com/tchssk/goaplugins/v3/autotrailingslash" . "goa.design/goa/v3/dsl" )

codegendisabler は Goa v3 のプラグインで、コードジェネレータの部分的な無効化を可能にします。 github.com プラグインの有効化 プラグインを有効にするには、下記のように codegendisabler の package を import します。 import ( _ "github.com/tchssk/goaplugins/codegendisabler/gen/http/client/types/client_body_init" . "goa.design/goa/v3/dsl" ) このコードは、 gen/http/<service>/client/types.goというファイル にコード生成を行う処理の内、 client-body-init というセクションテンプレート名の箇所を無効化します。 codegendisabler 配下の packa

これは Go3 Advent Calendar 2017 の 10 日目の記事です。 小さな役割を持つサービス群でアプリケーションを構成する、いわゆる Microservices が流行して久しいですね。サービスが細かく分割されるとき、それらを取りまとめるサービスが必要になることがあります。一般に API Gateway や API Aggregator と呼ばれるものです。 そんな API Gateway のひとつに Go で書かれた KrakenD というものがあります。 KrakenD - Open source API Gateway 今回はこれを試してみます。 仕様 複数のバックエンド API を集約 (aggregate) する動きを見るため、以下のような仕様でサービスを構築してみます。 バックエンドに GitHub と Qiita の Web API を使用する Kraken

goa には静的ファイル配信のための DSL として Files が用意されており、以下のような定義を行うと FileServer を生成してくれます。 Files("/swagger/*filepath", "public/swagger/") 生成される FileServer は http.FileSystem という interface を通してファイルオープンを行うのですが、従来は http.Dir という実装を固定で使う仕様になっていました。 http.Dir は実行環境のネイティブファイルシステムからファイルオープンを行います。これは、ビルドしたバイナリを実行環境にデプロイする際に Files で定義した静的ファイルもそのファイルシステム上に配置する必要がある、ということを意味します。 Go は、ビルドしたバイナリひとつをデプロイすれば動作する、いわゆるシングルバイナリが魅力の

goa へのプルリクエストの送り方 (バックポート編) です。 goa では互換性維持のため master と v1 を別ブランチで管理しています。そのため、プルリクエストが master にマージされたあと、その変更を v1 ブランチにバックポートするようお願いされることがあります。本編ではその手順について解説します。 1. リポジトリに移動 コンソールで以下のコマンドを実行します。 $ cd $GOPATH/src/github.com/goadesign/goa 2. v1 から新しいブランチをチェックアウト コンソールで以下のコマンドを実行します。 $ git fetch $ git checkout -b $BRANCHNAME origin/v1 $BRANCHNAME には任意のブランチ名を入れてください。例えばブランチ名を foo-bar-v1 とする場合は以下の様になりま

goa 公式サイトを日本語翻訳した 昨年始めた goa 公式サイトの日本語翻訳が終わりました。 goa.design 日本の開発者にあまり使われてないのは日本語のリソースが少ないからでは、ということで昨年末に ikawaha さんとプロジェクトを開始したのですが、結構分量があったので数ヶ月かかってしまいました。細かい修正は残っているものの、一旦は年度内に完了できてよかったです。 Go で Web API の開発を行う際には是非 goa を候補に加えてみて下さい。 goa の開発メンバーになった 2 月末に goa の開発メンバーになりました。 先日アナウンスされた v1.2.0 のポストでも大きく取り上げてもらいました。 goa.design 以下、引用です。 Taichi was one of the first contributors to goa, his contribution

goa のトップレベル DSL goa の design は DSL をネストさせながら記述しますが、その一番上の階層に来るものをトップレベル DSL と呼びます。標準で用意されている apidsl では以下の DSL がそれに当たります。 API() Resource() Type() MediaType() 前提として、すべての DSL は Go の関数であり、それを用いて記述される design は Go のソースコードです。 トップレベル DSL の記述 goa ではトップレベル DSL を以下のように記述します。 var _ = API("cellar", func() { // Definitions. }) なぜ以下のように書けないのでしょうか？ API("cellar", func() { // Definitions. }) Go の言語仕様 まず Go の言語仕様を確認

発表してきました。 connpass.com 春頃から goa を使ってきて自分なりのノウハウが溜まってきたところだったので、このような場で発表させて頂けてありがたかったです。スライドのボリューム不足を心配していたんですが 20 分というのは思ったよりも短くて、結果的には少しオーバーしてしまいました。 (すみません ...) もしまた発表する機会があったらもっとペース配分に気をつけようと思いました。 How I create a Microservice using goa - Slideck 他の方の発表も実践的な内容が多くて勉強になりました。使ったことないライブラリを知れることは勉強会に参加する意義のひとつですね。 参加した皆さま、特に主催の @ikawaha さんお疲れさまでした。 goa は簡単な修正でも pr 出すと"great!"とか"perfect!" とか全力で励ましてくれ