goインストール

Ubuntuの場合は主な手段は３つ

Ubuntu公式リポジトリからインストール
Ubuntu向けGO側リポジトリを追加してインストール
gvmインストールしてgo自体を取得＆自前ビルド

今回は「比較的簡単で比較的新しい」2.で入れました

goインストール

sudo add-apt-repository ppa:evarlast/golang1.5
sudo apt-get update
sudo apt-get install golang

2015/10現在
Ubuntu公式のパッケージは古くておすすめできません
- なので外リポジトリから取ってます
最新で行くなら当然ながらgvmになります
- groovyの環境マネージャと名前被ってるねんけど…

GOPATH設定

$GOPATHのには２つの役割が在ります。

ビルド時のインポートパス(":"で複数指定可)
"go get"での外部パッケージDL先(複数指定のひとつ目)

とりあえず「go関係はLibも自ソースもHomeディレクトリの /go に入れる」と決めて…以下の方法で片付けました。

echo 'export GO_WORKSPACE=current' >> ~/.bashrc
echo 'export GOPATH=~/go/third:~/go/${GO_WORKSPACE}' >> ~/.bashrc
echo 'export PATH=${PATH}:~/go/third/bin:~/go/${GO_WORKSPACE}/bin' >> ~/.bashrc
mkdir -p ~/go/{third,${GO_WORKSPACE}}
mkdir -p ~/go/${GO_WORKSPACE}/{src,bin,pkg}

※$GO_WORKSPACE は「プロジェクト始めるごとに切替」前提

※最後の一行は、golang的に規定されている $GOPATH (ひとつ目) に必要な3つです。

GOPATH設定

こんな感じ！

[HOME]/go
├── current
│   ├── bin
│   ├── pkg
│   └── src
└── third
    ├── bin
    ├── pkg
    └── src

IDEインストール

IDEは「InteliJ IDEA Community Edition」+「go-lang-idea-plugin」で行こうと思います。

# リポジトリ追加
sudo add-apt-repository
ppa:ubuntu-desktop/ubuntu-make
sudo apt-get update
sudo apt-get upgrade
# Ubuntu make インストール
sudo apt-get install ubuntu-make
# InteliJ自体のインストール
umake ide idea
Choose installation path: /home/[おまえさん]/tools/ide/idea

「Ubutntu make」という「公式と別のパッケージ管理」経由です。時間はかかりましたが、トラブル無く完了。

IDE設定

IDEAに「go-lang-idea-plugin」を入れていきます…。

が、GUIなので手順だけ。(詳しくはこちらのサイトへ)

Preference -> Plugins -> Browse Repositories から「Manage repositories」ボタン押す
開いた「Custom Plugin Repositories」で"https://plugins.jetbrains.com/plugins/alpha/list"を追加する
Browse Repositoriesに戻り、足したリポジトリでフィルタ
"Go"というプラグインが表示されるので「Install Plutin」
再起動後、Project Structure -> Platform Settings -> SDKs で「Add New SDK」押す
golangの場所を指定

プロジェクト作成

(俗に言う)プロジェクト作成

「プロジェクト」というのは「Java/MS的な考え方」なんですが「プログラムの塊の単位」です。

今回、プロジェクトは…

名前は"go-first-project"
githubに載せる前提

で、とりあえずディレクトリを作成しました。

mkdir -p ~/go/${GO_WORKSPACE}/src/github.com/kazuhito-m/go-first-project
cd ~/go/${GO_WORKSPACE}/src/github.com/kazuhito-m/go-first-project
# ついでにgit初期化＆登録
# (すでにgithub側に"go-first-project"というリポジトリを作成してある事)
git init
echo "/*.i??" > .gitignore # IDEA無視用
git add ./
git commit ./ -m '最初のコミット'
git remote add origin https://github.com/kazuhito-m/go-first-project.git
git push -u origin master

(俗に言う)プロジェクト作成

こんな感じ！

[HOME]/go
├── current
│   ├── bin
│   ├── pkg
│   └── src
│       └── github.com
│           └── kazuhito-m
│               └─ go-first-project
└── third
    ├── bin
    ├── pkg
    └── src

プログラム
書き初め

まずは「一行プログラム」

cd ~/go/${GO_WORKSPACE}/src/github.com/kazuhito-m/go-first-project
vi main.go

で

package main

import "fmt"

func main() {
    fmt.Println("Hello World!")
}

でもって

go install
# ＄PATH で $GOPATH/bin にパス通ってるので…
go-first-project
Hello World!

まずは「一行プログラム」

月並みながら…なんだかうれしいっすね！

後々のこと考えて

touch build.sh
chmod 755 build.sh
vi build.sh

#!/bin/bash
# ビルド・インストール
go install

なスクリプトを用意しました。

※ここからの作業はこちらのリポジトリから参照いただけます。

初めてのインポート

これまた月並みですが…main.goを以下のように改造。

package main

import (
    "fmt"
    "github.com/bitly/go-simplejson"
)

func main() {
    fmt.Println("Hello World!")
    // 文字列json化の例
    json := simplejson.New()
    json.Set("message", "Hello, World!")
    b, _ := json.EncodePretty()
    fmt.Printf("%s\n", b)
}

初めての"go get"

go get github.com/bitly/go-simplejson
# $GOPATH の設定により ~/go/third 側に入って行くはず

初めてのインポート

実行してみる。

go install
go-first-project
Hello World!
{
  "message": "Hello, World!"
}

ビルドスクリプト"build.sh"を改造。

#!/bin/bash
# 依存性解決のgo get(ソースから自動解決)
go get
# ビルド・インストール
go install

テスト準備とパッケージ分け

唐突ですが、こんなふうに「足し算・引き算するパッケージ」を作り、テストも追加してみました。

.
├── build.sh
├── calc
│   ├── add.go
│   ├── add_test.go
│   ├── sub.go
│   └── sub_test.go
└── main.go

そりゃ実行でしょう！

go test ./calc

ok      github.com/kazuhito-m/go-first-project/calc    0.004s

やったぜ！

テスト準備とパッケージ分け

ビルドスクリプト"build.sh"を改造。

#!/bin/bash
# 依存性解決のgo get(ソースから自動解決)
go get
# テスト
go test ./...
if [[ $? -ne 0 ]] ; then
  echo 'Test failed and Build failed!'
  exit 1
fi
# ビルド・インストール
go install

./build.sh
?       github.com/kazuhito-m/go-first-project    [no test files]
ok      github.com/kazuhito-m/go-first-project/calc    0.003s

再帰的テストする指定だけど…「テスト無い」証左だし出しとこ。

CI
(継続的インテグレーション)

CI準備

CI準備-CircleCI設定

テストが出来るなら「テストがコケたら怒ってくれるモノ=CI」を、仕込んできたくなるので仕込みます。

ローカルでJenkins…がいつものオレですが

「GOが普及し、整備されている」

を示すため「ネット上CIサービス」を使って行きたく思います。

TraviceCI, drone.io等、最近は色々あるようですが、

CircleCI

を使って行きたいと思います。

CI準備-CircleCI設定

まずCircleCIにサインアップ＆ログインします。

https://circleci.com へ行き、「Sign Up Free」 -> 「Authorize With Github」とクリックして下さい。

サイトに入る事ができれば
「どのアカウントを使うか」を選択して下さい。

アカウント選択

CI準備-CircleCI設定

アカウントを選択すると「githubのリポジトリが一覧」されます。

今回のGOのプロジェクトを見つけ、
右端の「Build Project」をクリックして下さい。

リポジトリ選択

ビルドが始まりますので結果を注視して下さい。

※今回サンプルに使用しているリポジトリのビルドはここで見れます。

CI準備-CircleCI設定

例により

「GithubリポジトリのREADMEにバッジ貼っとく」

とかっこいいかも？

SuccessBadge!

CI通知系準備

CI通知系準備-メール

基本的な通知「メール」を設定します。

CircleCIログイン状態で画面左の「アイコン」をクリックします。

今回は「動いてるを意識する」ため「絶えず送信」に変更。

CI通知系準備-チャット

次はチャットです。好みの問題でSlackを使います。

アカウント、チームはすでに在るもの
ログインしている

を前提にします。

CI通知系準備-チャット

ログインしているチャットのURLを削り、

https://[なんちゃら].slack.com/services/new/incoming-webhook

というURLを指定してください。

ChannelSelect

「Post to Channel」という項目が現れるので「Choose a channel...」から「通知を投げ込みたいチャンネル」を選んで下さい。

CI通知系準備-チャット

Channelを選ぶと「Add Incoming WebHooks Integration」というボタンがあらわれますのでクリックして下さい。

「Webhook URL」という項目が現れるので、そのURLをコピーして置いて下さい。

CI通知系準備-チャット

CircleCIに戻り、プロジェクト画面から「Project Settings」
-> (左メニューの)「Chat Notifications」をクリックして下さい。

ChatSettings

先ほどのURLを「Webhook URL」に入力、Saveして下さい。

CI通知系準備-番外

なんとなく…

「コケたら音声で教えてくれる」

とかしてくれたらいいのに…。(伏線)

周回遅れのgolang