ansible-gvm-module

gvmコマンドを実行するためのansibleモジュールです。

https://galaxy.ansible.com/suzuki-shunsuke/gvm-module/

注意

• このモジュールはチェックモードをサポートしていません。
• gvmはGo Version Managerの略であり、このモジュールはGroovy enVironment Managerとは関係ありません。

対応プラットフォーム

• GenericLinux
• MacOSX

このモジュールは以下でテストしています。

• Ubuntu 16.04 (Vagrant, Virtualbox)
• CentOS 7.3 (Vagrant, Virtualbox)
• MacOS Sierra 10.12.5

要件

• gvm
• golangビルド依存関係

ansibleロールを使用してgvmとgolangのビルド依存関係をインストールしたい場合は、suzuki-shunsuke.gvmをお勧めします。

サポートされているgvmサブコマンドとオプション

$ gvm install <version> [--binary] [--prefer-binary] [--with-build-tools] [--with-protobuf]
$ gvm uninstall <version>
$ gvm list
$ gvm listall
$ gvm alias list
$ gvm alias create <alias> <version>
$ gvm alias delete <alias>

インストール

$ ansible-galaxy install suzuki-shunsuke.gvm-module

# playbook.yml

- hosts: default
  roles:
  # このロールを呼び出した後に、このモジュールを使用できます。
  - suzuki-shunsuke.gvm-module

オプション

共通オプション

名前	型	必須	デフォルト	選択肢 / 例	説明
subcommand	str	いいえ	install	[install, uninstall, list, listall, alias list, alias create, alias delete]
gvm_root	str	いいえ		~/.gvm	環境変数"GVM_ROOT"が設定されていない場合、このオプションは必須です
expanduser	bool	いいえ	yes		デフォルトでは、環境変数GVM_ROOTと"gvm_root"オプションはos.path.expanduserによってフィルタリングされます

"install"サブコマンドのオプション

パラメータ	型	必須	デフォルト	選択肢 / 例	説明
version	str	はい		go1.4
binary	bool	いいえ	no		コンパイルエラーを避けたい場合は、"yes"に設定することをお勧めします
prefer_binary	bool	いいえ	no
with_build_tools	bool	いいえ	no
with_protobuf	bool	いいえ	no

"uninstall"サブコマンドのオプション

パラメータ	型	必須	デフォルト	選択肢 / 例	説明
version	str	はい		go1.4

"list"サブコマンドのオプション

何もありません。

"list"サブコマンドの返り値には"versions"フィールドがあります。

"listall"サブコマンドのオプション

何もありません。

"listall"サブコマンドの返り値には"versions"フィールドがあります。

"alias list"サブコマンドのオプション

何もありません。

"alias list"サブコマンドの返り値には"aliases"フィールドがあります。

"alias create"サブコマンドのオプション

パラメータ	型	必須	デフォルト	選択肢 / 例	説明
version	str	はい		go1.4
alias	str	はい		foo

"alias delete"サブコマンドのオプション

パラメータ	型	必須	デフォルト	選択肢 / 例	説明
alias	str	はい		foo

例

- name: gvm install go1.4
  gvm:
    version: go1.4
    gvm_root: "~/.gvm"

- name: gvm install go1.5 --binary
  gvm:
    version: go1.5
    gvm_root: "~/.gvm"
    binary: yes

- name: gvm uninstall go1.5
  gvm:
    subcommand: uninstall
    version: go1.5
    gvm_root: "~/.gvm"

- name: gvm list
  gvm:
    subcommand: list
    gvm_root: "~/.gvm"
  register: result
- debug:
    var: result.versions

- name: gvm listall
  gvm:
    subcommand: listall
    gvm_root: "~/.gvm"
  register: result
- debug:
    var: result.versions

- name: gvm alias create foo go1.4
  gvm:
    subcommand: alias create
    version: go1.4
    alias: foo
    gvm_root: "~/.gvm"

- name: gvm alias list
  gvm:
    subcommand: alias list
    gvm_root: "~/.gvm"
  register: result
- debug:
    var: result.aliases

- name: gvm alias delete foo
  gvm:
    subcommand: alias delete
    alias: foo
    gvm_root: "~/.gvm"

変更履歴

CHANGELOG.mdを参照してください。

関連リンク

• suzuki-shunsuke.gvm: gvmをインストールするためのansibleロール

ライセンス

MIT

開発

要件

• Vagrant
• Ansible
• Node.js
• yarn

セットアップ

$ yarn install
$ cd tests
$ ansible-galaxy install -r roles.yml

テスト

$ cd tests
$ vagrant up --provision