サービス

ジャンル

<h2 id="はじめに">はじめに</h2>

<p>こんにちは。DMM.comラボ プラットフォーム開発部エンジニアの松下 (<a href="https://twitter.com/_kentaro_m" target="_blank">@_kentaro_m</a>) です。DMMのサービス全体で利用される基盤システムの開発を担当しています。</p>

<p>最近、個人的に興味を持ったGo言語の学習の一環として、社内情報共有ツールになっているConfluenceを便利に使うためのCLIツール開発に挑戦したので、本記事ではその学習の流れを紹介したいと思います。</p>

<p>これからGoを学びたいと考えているエンジニアの参考になれば幸いです。</p>

<h2 id="Goの学習をはじめた動機">Goの学習をはじめた動機</h2>

<p>普段はNode.jsをメインで開発しており、Goはまったく触る機会がありませんでした。社内で開催されたGoの勉強会のレポートを見たり、ブラウザプッシュ通知の開発チームでプロダクトに採用された話を聞いたりして興味を持ち、個人で勉強するようになりました。</p>

<h2 id="Goの学習の流れ">Goの学習の流れ</h2>

<p>Goの学習は以下のように進めました。</p>

<ol>
	<li>A Tour of Goを行う</li>
	<li>ローカル開発環境を構築する</li>
	<li>CLIツール開発に挑戦する</li>
</ol>

<h3 id="1-A-Tour-of-Goを行う">1. A Tour of Goを行う</h3>

<p>A Tour of Goはブラウザ上でGoの文法が学べる公式のチュートリアルです。CLIツールを開発するにあたって、事前にひととおり行いました。</p>

<p>基本的にはスライドを見つつ、サンプルコードを動かして学んでいきます。各章の終わりには演習問題があり、それを解いて理解度を測れるようになっていました。私は演習問題で何度かハマったので、もう何周かして理解を深めたいです。</p>

<p><a href="https://go-tour-jp.appspot.com/welcome/1" target="_blank">A Tour of Go</a></p>

<h3 id="2-ローカル開発環境を構築する">2. ローカル開発環境を構築する</h3>

<p>ローカル開発環境の構築には次の3つを行いました。</p>

<ul>
	<li>homebrewでのGoのインストール</li>
	<li><code>GOPATH</code>を設定</li>
	<li>エディタに開発補助パッケージをインストール</li>
</ul>

<h4 id="homebrewでのGoのインストール">homebrewでのGoのインストール</h4>

<p>Macをお使いであれば、homebrewでGoをインストールするのが一番早いと思います。</p>

<pre>
<code>$ brew install go</code></pre>

<h4 id="GOPATHを設定">GOPATHを設定</h4>

<p><code>~/.bash_profile</code>にGoのワークスペース(<code>GOPATH</code>)の指定と、GOPATH配下の<code>bin</code>ディレクトリをPATHに追加します。</p>

<pre>
<code>export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin</code></pre>

<p>設定ファイルを読み込み直します。</p>

<pre>
<code>$ source ~/.bash_profile</code></pre>

<ul>
	<li><a href="https://golang.org/doc/code.html#GOPATH" target="_blank">How to Write Go Code - The Go Programming Language</a></li>
	<li><a href="https://github.com/golang/go/wiki/SettingGOPATH" target="_blank">SettingGOPATH &middot; golang/go Wiki</a></li>
</ul>

<h4 id="エディタに開発補助パッケージをインストール">エディタに開発補助パッケージをインストール</h4>

<p>お使いのエディタに合わせて、必要なものを入れてください。</p>

<h3 id="3-CLIツール開発に挑戦する">3. CLIツール開発に挑戦する</h3>

<p>Goの学習でCLIツール開発に挑戦した理由は以下の3つです。</p>

<ul>
	<li>Goではクロスコンパイルをサポートしており、各種プラットフォーム向けにCLIツールを配布しやすいこと</li>
	<li>Go向けのCLIツール開発を支援するフレームワークが存在すること</li>
	<li>GoでCLIツール開発に挑戦する人が多く、情報量が多いこと</li>
</ul>

<h2 id="CLIツールの開発を始める">CLIツールの開発を始める</h2>

<h3 id="何を開発するか">何を開発するか</h3>

<p>DMMでは社内情報共有のためにAtlassianの<a href="https://ja.atlassian.com/software/confluence" target="_blank">Confluence</a>が多くの部署で利用されています。ドキュメントをリッチテキストで書けるため、誰でも簡単に扱えるのが特徴です。</p>

<p>一方でドキュメントを書きながら、装飾もしなくてはいけないため、Markdownを好むエンジニアにとっては使いづらい一面<sup id="fnref:1"><a href="https://inside.hatenablog.jp/entry/2018/05/28/golang-cli-tool#fn:1" rel="footnote">1</a></sup>もありました。</p>

<div style="text-align:center">
<figure class="image" style="display:inline-block"><img alt="" height="462" src="https://image.dmm-corp.com/wj0kqgl14nf4cyhbof8xl48w4ge7" width="700" />
<figcaption>Confluence Wikiマークアップのテキストを挿入するときの画面</figcaption>
</figure>
</div>

<p>そこでMarkdownをConfluenceの独自記法であるWikiマークアップに変換する仕組みを作り、Markdown文書をConfluenceへ容易に投稿できる環境を実現することにしました。</p>

<h3 id="作ったもの">作ったもの</h3>

<p>Markdownを<a href="https://ja.confluence.atlassian.com/confcloud/confluence-wiki-markup-938044804.html" target="_blank">Confluence Wikiマークアップ</a>に変換するmd2conflというCLIツールを作りました。</p>

<p><a href="https://github.com/kentaro-m/md2confl">https://github.com/kentaro-m/md2confl</a></p>

<p>ファイルまたは標準入力から読み込んだMarkdownの文書をConfluenceのWikiマークアップに変換して、標準出力に出力します。</p>

<pre>
<code>$ md2confl sample.md
h1. Section
Some _Markdown_ text.

* list1
* list2
* list3

*strong text*
-strikethrough text-
[Example Domain|http://www.example.com/]
!https://blog.golang.org/gopher/header.jpg!

$ echo "# Hello, world" | md2confl
h1. Hello, world</code></pre>

<p>Macをお使いであれば、homebrewからインストールが可能です。その他のプラットフォーム向けにもGitHub Releaseにバイナリが<a href="https://github.com/kentaro-m/md2confl/releases" target="_blank">公開</a>されています。</p>

<pre>
<code>$ brew tap kentaro-m/md2confl
$ brew install md2confl</code></pre>

<h2 id="CLIツールをリリースするまでの流れ">CLIツールをリリースするまでの流れ</h2>

<p>次にCLIツールをリリースするまでに行った3つの作業を紹介したいと思います。</p>

<ol>
	<li>CLIツールのフレームワークで雛形を作成</li>
	<li>Markdownパーサーのカスタムレンダラの開発</li>
	<li>Circle CIでリリースの仕組みを準備</li>
</ol>

<h3 id="CLIツールのフレームワークで雛形を作成">CLIツールのフレームワークで雛形を作成</h3>

<p>GoではCLIツールを簡単に素早く開発するためのフレームワークがあります。今回はKubernetesやDockerでも採用されている<a href="https://github.com/spf13/cobra" target="_blank">spf13/cobra</a>を使用しました。</p>

<p><a href="https://github.com/spf13/cobra">https://github.com/spf13/cobra</a></p>

<p>数ステップでCLIツールの雛形を作成することができます。</p>

<p>cobraをインストールします（<code>$GOPATH/bin</code>にインストールされる）。</p>

<pre>
<code>$ go get github.com/spf13/cobra/cobra</code></pre>

<p><code>cobra init &lt;アプリケーション名&gt;</code>で雛形が作成されます。</p>

<pre>
<code>$ cobra init github.com/kentaro-m/sampleApp
$ cd $GOPATH/src/github.com/kentaro-m/sampleApp
$ go run main.go
Your Cobra application is ready at
~/go/src/github.com/kentaro-m/sampleApp

Give it a try by going there and running `go run main.go`.
Add commands to it by running `cobra add [cmdname]`.</code></pre>

<p><code>cobra add</code>コマンドでサブコマンドが追加されます。</p>

<pre>
<code>$ cobra add show
show created at ~/go/src/github.com/kentaro-m/sampleApp/cmd/show.go

$ go run main.go
A longer description that spans multiple lines and likely contains
examples and usage of using your application. For example:

Cobra is a CLI library for Go that empowers applications.
This application is a tool to generate the needed files
to quickly create a Cobra application.

Usage:
  sampleApp [command]

Available Commands:
  help        Help about any command
  show        A brief description of your command

Flags:
      --config string   config file (default is $HOME/.sampleApp.yaml)
  -h, --help            help for sampleApp
  -t, --toggle          Help message for toggle

Use "sampleApp [command] --help" for more information about a command.

$ go run main.go show
show called</code></pre>

<p>この時点でのディレクトリは以下のとおりです。</p>

<pre>
<code>.
├── LICENSE
├── cmd
│   ├── root.go
│   └── show.go // 追加したサブコマンド
└── main.go</code></pre>

<p>あとは<code>cmd/show.go</code>に必要な処理を追加すれば、オリジナルのCLIツールが完成します。 今回作成したCLIツールは、この雛形をベースに開発していきました。</p>

<pre>
<code class="language-go">package cmd

import (
    "fmt"

    "github.com/spf13/cobra"
)

// showCmd represents the show command
var showCmd = &amp;cobra.Command{
    Use:   "show",
    Short: "A brief description of your command",
    Long: `A longer description that spans multiple lines and likely contains examples
and usage of using your command. For example:

Cobra is a CLI library for Go that empowers applications.
This application is a tool to generate the needed files
to quickly create a Cobra application.`,
    Run: func(cmd *cobra.Command, args []string) {
    // ここに処理を書く
        fmt.Println("show called")
    },
}

func init() {
    RootCmd.AddCommand(showCmd)
}</code></pre>

<h3 id="Markdownパーサーのカスタムレンダラの開発">Markdownパーサーのカスタムレンダラの開発</h3>

<p>Go製のマークダウンパーサー</p>

<p><a href="https://github.com/russross/blackfriday">https://github.com/russross/blackfriday</a></p>

<p>Confluence Wikiマークアップを出力するBlackfridayカスタムレンダラ</p>

<p><a href="https://github.com/kentaro-m/blackfriday-confluence">https://github.com/kentaro-m/blackfriday-confluence</a></p>

<p>MarkdownのパースとConfluence Wikiマークアップへの変換は<a href="https://github.com/russross/blackfriday" target="_blank">russross/blackfriday</a>を使用しました。このライブラリはデフォルトではMarkdownをHTMLに変換するようになっていますが、カスタムレンダラを使用することでLaTeXなどの他言語の出力が可能になります。</p>

<p>md2conflを開発するにあたり、Confluence Wikiマークアップを出力するレンダラを作成しました。正しい出力を得るためにマークダウンの各要素ごとにユニットテストを作成し、出力を確認しながら開発を進める非常に愚直な作業でした。</p>

<pre>
<code class="language-go">// マークダウンの各要素ごとにユニットテストを作成
func TestHeading(t *testing.T) {
  // マークダウン形式のテキスト (入力値)
    input := `
# Section
hello, world.
`
  // Confluece Wikiマークアップのテキスト (期待値)
    expected := `h1. Section
hello, world.
`

  // Confluece Wikiマークアップ変換後のテキスト (出力結果)
    output := string(bfconfluence.Run([]byte(input)))

  // 出力結果と期待値を比較
    if output != expected {
        t.Errorf("got:%v\nwant:%v", output, expected)
    }
}
</code></pre>

<h3 id="Circle-CIでリリースの仕組みを準備">Circle CIでリリースの仕組みを準備</h3>

<p>クロスコンパイルを実施してバイナリを生成</p>

<p><a href="https://github.com/mitchellh/gox">https://github.com/mitchellh/gox</a></p>

<p>GitHub Releaseのページ作成及びバイナリをアップロード</p>

<p><a href="https://github.com/tcnksm/ghr">https://github.com/tcnksm/ghr</a></p>

<p>バイナリを配布するためにCircle CIとgox、ghrでリリースの仕組みを準備しました。最終的に以下の構成の<code>config.yml</code>ができあがりました。</p>

<p>Gitで<code>v.X.Y.Z</code>のバージョンタグを付与して、リモートにプッシュしたタイミングでCircle CIがクロスコンパイルを行い、リリースページにバイナリをアップロードします。</p>

<p>これでCLIツールを配布できるようになりました。</p>

<pre>
<code>version: 2
jobs:
  build:
    docker:
      - image: circleci/golang:1.10
    working_directory: /go/src/github.com/kentaro-m/md2confl
    steps:
      - checkout
      - run:
          name: Install dependencies
          command: go get -v -t -d ./...
      - run:
          name: Run linters
          command: |
            go get github.com/golang/lint/golint
            golint ./...
            go vet ./...
  deploy:
    docker:
      - image: circleci/golang:1.10
    working_directory: /go/src/github.com/kentaro-m/md2confl
    steps:
      - checkout
      - run:
          name: Deploy the project
          command: |
            go get -v -t -d ./...
            go get github.com/inconshreveable/mousetrap
            go get github.com/mitchellh/gox
            go get github.com/tcnksm/ghr
            # クロスコンパイル・バイナリ生成
            gox -output "pkg/{{.OS}}_{{.Arch}}_{{.Dir}}"
            # GitHub Releaseにバイナリ公開
            # repo権限を付与したトークンを環境変数に登録しておく
            ghr -t $GITHUB_TOKEN -u $CIRCLE_PROJECT_USERNAME -r $CIRCLE_PROJECT_REPONAME --replace `git describe --abbrev=0 --tags` pkg/
workflows:
  version: 2
  build:
    jobs:
      - build:
          filters:
            branches:
              only: /.*/
  deploy:
    jobs:
      - deploy:
          filters:
            branches:
              ignore: /.*/
            tags: # タグが付与されたときのみジョブが実行される
              only: /v[0-9]+\.[0-9]+\.[0-9]+/</code></pre>

<h2 id="まとめ">まとめ</h2>

<p>普段の業務で使うプログラミング言語やツールは、比較検討を重ねて選定していきます。Goの学習に関しては、個人的な勉強なので純粋に楽しそうという理由で触りました。結果的にCLIツールを開発してリリースするところまででき、今はさらに深くGoを学びたいという気持ちになっています。</p>

<p>概算になりますが、学習時間を簡単に紹介したいと思います。</p>

<div style="text-align:center">
<figure class="image" style="display:inline-block"><img alt="" height="249" src="https://image.dmm-corp.com/wy2yt5c6ir5ohxwiitjeuern9426" width="700" />
<figcaption>Goの学習時間</figcaption>
</figure>
</div>

<p>平日帰宅後に1時間くらい時間をとってコツコツと進めて、Goの学習開始からリリースまでおよそ30時間でした。 最初に作るものを決めて、それを作るためには何を勉強すべきかという点を考えながらやったので、学習効率は良かったと思います。</p>

<p>今回はCLIツールを完成させてリリースすることに重きを置いていたため、エラーハンドリングやテストの書き方などGoの作法が分からないまま、おざなりに進めてしまった部分がありました。今後はGoらしいコードを書くために勉強を続けていきたいと思います。</p>

<p>皆さんも何か作るものを1つ決めて、Goの学習を始めてみてはいかがでしょうか。</p>

<p>&nbsp;</p>


Go言語初学者がConfluenceをMarkdownで書くためのCLIツールを開発した話

シェア