Go ツールセットは、Red Hat Enterprise Linux プラットフォームで開発者向けの Red Hat 製品です。Go ツールセット 1.13 は、Go プログラミング言語ツールおよびライブラリーを提供します。Go は、golang としても知られています。

Go ツールセットは、Red Hat Enterprise Linux 7 の一部として配布されており、Red Hat Enterprise Linux 8 でモジュールとして利用できます。

以下のコンポーネントは、Go ツールセットの一部として利用できます。

Go ツールセットは、Red Hat Enterprise Linux 7 および Red Hat Enterprise Linux 8 では、以下のアーキテクチャーで利用できます。

本章では、Red Hat Enterprise Linux 7 システムに Go ツールセットをインストールする前に実行する手順を説明します。以下の手順をすべて実行して、Red Hat Developer Toolset レポジトリーにアクセスできるサブスクリプションをアタッチし、Red Hat Developer Tools および Red Hat Software Collections レポジトリーを有効化します。

前提条件

手順

サブスクリプションがシステムに割り当てられ、リポジトリーが有効になったら、「Go ツールセットのインストール」 の説明に従って Go ツールセットをインストールします。

関連資料

Go ツールセットは、Red Hat Enterprise Linux に含まれる標準のパッケージ管理ツールを使用してインストール、更新、アンインストール、および検査できる RPM パッケージのコレクションとして配布されています。Go ツールセットを Red Hat Enterprise Linux 7 システムにインストールするには、Red Hat Developer Tool コンテンツセットへのアクセスを提供する有効なサブスクリプションが必要です。Red Hat Enterprise Linux 7 システムを適切なサブスクリプションに関連付け、Go ツールセットにアクセスする方法は、「Red Hat Enterprise Linux 7 で Go ツールセットへのアクセス」 を参照してください。

関連情報

インストール可能なドキュメント

Go ツールセットインストール可能なドキュメントをインストールするには、以下の手順を実行します。

インストール可能なドキュメントは、 /opt/rh/go-toolset-1.13/root/usr/lib/go-toolset-1.13-golang/doc/docs.html にインストールされます。

インストール可能なドキュメントは/usr/lib/golang/doc/docs.html にインストールされます。

Go ツールセットおよびその機能の詳細は、本書の対象外となります。詳細は、以下に記載のドキュメントを参照してください。

オンラインドキュメント

Go プログラムを作成する場合、開発者は Go ワークスペースレイアウトのルールに従う必要があります。.go ソースファイルは、$GOPATH/src のサブディレクトリーに配置する必要があります。

$ mkdir -p $GOPATH/src/hello
$ cd $GOPATH/src/hello
$ touch hello.go

package main

import (
    "fmt"
    "net/http"
)

func Welcome(w http.ResponseWriter, req *http.Request) {

    fmt.Fprintf(w, "<h1>Welcome to Go Toolset.</h1>")

}

func main() {

    fmt.Println("Hello.")
    fmt.Println("Starting http server.")
    // Register handler function
    http.HandleFunc("/welcome", Welcome)
    fmt.Println("Go to localhost:8080/welcome")
    fmt.Println("To terminate press CTRL+C.")
    // Start server
    http.ListenAndServe(":8080", nil)

}

関連情報

コマンドラインを使用して Go プログラムを構築するには、プロジェクトディレクトリーに移動し、以下のように go コンパイラーを実行します。

これにより、現在の作業ディレクトリーに output_file という名前のバイナリーファイルが作成されます。-o オプションを省略すると、コンパイラーは go_main_package、go_main_package の名前でファイルを作成します。

go_main_package がメインパッケージではない場合や、複数のプロジェクトや *.go ファイルが指定されている場合は、生成されるバイナリーは破棄されます。この場合、go build コマンドを使用して、提供されたプロジェクトまたはファイルをビルドできることを確認します。

$ scl enable go-toolset-1.13 'bash'

プログラムを go コンパイルすると、実行可能なバイナリーファイルが作成されます。コマンドラインでこのプログラムを実行するには、実行ファイルがあるディレクトリーに移動し、プログラムを実行します。

$ ./file_name

$ ./hello
Hello.
Starting http server.
Go to localhost:8080/welcome
To terminate press CTRL+C.

Go プロジェクトをインストールすると、実行ファイルとライブラリーがコンパイルされ、Go Workspace の適切なディレクトリーにコピーされます。その後、go ツールは、追加のプロジェクトで実行ファイルおよびライブラリーを使用できます。インストールされたプロジェクトの依存関係もインストールされます。したがって、作業中のプロジェクトに追加され、別の構造を形成せず、すべての Go プロジェクトをまとまりのあるシステムにします。

Go プロジェクトをインストールするには、go ツールを実行します。

install コマンドは、build コマンド と同じオプションを受け入れます。

サードパーティーの Go プロジェクトをオンラインソースからダウンロードし、インストールするには、go ツールを実行します。

3rd_party_go_project オプションで使用できる値の詳細は、以下のコマンドを実行します。

go およびその機能の詳しい説明は、本書の対象外となっています。詳細は、以下に記載のドキュメントを参照してください。

インストールされているドキュメント

オンラインドキュメント

以下も併せて参照してください。

code_path パスのすべてのコードをフォーマットするには、以下のように gofmt ツールを実行します。

このコマンドは、code_path パスを直接変更します。code_path が 1 つのファイルである場合、変更はファイルにのみ適用されます。code_path がディレクトリーである場合は、ディレクトリー内のすべての .go ファイルが処理されます。

code_path を省略すると、gofmt は代わりに標準入力を読み込みます。

元のファイルに書き込みせずにフォーマットされたコードを標準出力に出力するには、-w オプションを省略します。

指定したパス code_path でコードをフォーマットしてプレビューするには、以下のように -d オプションを指定して gofmt を実行します。

統一された diff 形式の出力は、標準出力に出力されます。

-d および -w オプションの両方を組み合わせることができます。

指定されたパス code_path でコードを簡素化するには、以下のように -s オプションを指定して gofmt オプションを実行します。

code_path の下にあるコードは簡素化されます。-d オプションを使用して違いを表示し、-w オプションを使用してコードに変更を適用します。

gofmt ツールは、任意の置換を適用してコードをリファクタリングするために使用できます。ルール rewrite_rule に従って、指定のパス code_path のコードをリファクタリングするには、以下のように -r オプションを指定して gofmt ツールを実行します。

code_path のコードは、ルール rewrite_rule に従ってリファクタリングされます。-d オプションを使用して違いを表示し、-w オプションを使用してコードに変更を適用します。追加オプションは、ルール rewrite_rule の後に配置する必要があります。

書き換えルールに関する詳しい説明は、本書の対象外です。詳細は、「関連情報」 に記載されているリソースを参照してください。

gofmt ツールおよびその機能の詳しい説明は、本書の対象外となっています。詳細は、以下に記載のドキュメントを参照してください。

オンラインドキュメント

以下も併せて参照してください。

Red Hat Enterprise Linux 7 では、競合検出は、go-toolset-1.13-golang-race パッケージで提供されます。

# yum install go-toolset-1.13-golang-race

Red Hat Enterprise Linux 8 では、golang-race パッケージによって提供されます。

# yum install golang-race

このコマンドは、ランタイム競合検出を含む Go 標準ライブラリーのバリアントをインストールします。

Go プロジェクトでランタイム競合検出を使用するには、プロジェクトを操作するときに使用する go ツールコマンドに -race オプションを追加します。

競合検出を使用する最小限のアプローチには、-race オプションを指定してプロジェクトをビルドします。

生成された実行可能なバイナリーファイルを実行し、競合検出が検出されると、標準出力に警告が出力されます。

$ scl enable go-toolset-1.13 'bash'

Go 競合検出機能の詳細と、その機能は本ガイドの対象外です。詳細は、以下に記載のドキュメントを参照してください。

オンラインドキュメント

以下も併せて参照してください。

RHEL 7 および RHEL 8 コンテナーイメージは、次のパッケージに対応するコンテンツを提供します。

必要なイメージをプルするには、root で以下のコマンドを実行します。

# podman pull registry.redhat.io/devtools/go-toolset-rhel7

# podman pull registry.redhat.io/ubi7/go-toolset

# podman pull registry.redhat.io/rhel8/go-toolset

# podman pull registry.redhat.io/ubi8/go-toolset

Go ツールセットコンテナーイメージは、Source-to-Image(S2I) ビルダーイメージとして使用するために準備されます。

これを行うには、以下のビルド環境変数を設定します。

$ s2i build -e IMPORT_URL='github.com/cpuguy83/go-md2man' -e INSTALL_URL='github.com/cpuguy83/go-md2man' git://github.com/cpuguy83/go-md2man  registry.access.redhat.com/devtools/go-toolset-rhel7 md2man-app

Go を S2I ビルダーイメージとしてフルに活用するには、変更した S2I assemble スクリプトを使用し、ビルドしている特定のアプリケーションをさらに調整してカスタムイメージをビルドします。

Source-to-Image を使用した Go の使用方法の詳細な説明は、本書の対象外です。Source-to-Image の詳細は以下を参照してください。