0Pricing
Ansible Academy · レッスン

自作 Role を Galaxy に公開する

自動化を世界中で共有します。

「自作 Role を Galaxy に公開する」はCoddyKit上の無料Ansible Academyレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAnsible Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Ansible Academyコースには全4レッスンが含まれています。

Galaxyに貢献する

ロールで問題をきれいに解決できたら、それを共有できます。Galaxyで公開すれば、誰でも1つのコマンドであなたの成果物をインストールできます。

GalaxyはGitHubから読み取る

Galaxy自体はコードをホストしません。あなたが所有する公開GitHubリポジトリから、ロールを直接取り込みます。

1つのリポジトリに1つのロール

最もわかりやすい構成は、ansible-galaxy initで作成した標準的なひな形を使い、リポジトリのルートに1つのロールだけを配置することです。

ansible-galaxy init my_role

meta/main.ymlは必須

Galaxyはメタデータをmeta/main.ymlから読み取ります。インポートする前に、作成者、明確な説明、ライセンス、対応プラットフォームを記入してください。

galaxy_info:
  author: yourname
  description: Configure nginx
  license: MIT

実用的なREADMEを書く

README.mdはロールのトップページです。ロールの動作を説明し、受け付けるすべての変数を、わかりやすい例とともに一覧にしてください。

GitHubアカウントを接続する

GitHubを使ってgalaxy.ansible.comにログインします。これによりアカウントが連携され、Galaxyがリポジトリを確認してインポートできるようになります。

リポジトリをインポートする

Galaxyのダッシュボードからリポジトリを選択し、importを実行します。Galaxyがメタデータを読み取り、ロールを公開します。

CLIからインポートする

APIトークンとimportサブコマンドを使えば、ウェブサイトを使わずにインポートすることもできます。その際はGitHubのユーザー名とリポジトリ名を指定します。

ansible-galaxy role import yourname my_role

タグがバージョンになる

GalaxyはGitのタグをロールのバージョンに変換します。1.0.0のようなタグをプッシュすると、ユーザーは特定の安定版にバージョンを固定できます。

git tag 1.0.0
git push --tags

名前はリポジトリから決まる

公開されたロールの名前はgithub_user.repo_nameです。これは他のユーザーがrequirements.ymlで参照するときの名前とまったく同じです。

roles:
  - name: yourname.my_role

継続的に保守する

公開には責任が伴います。Issueに対応し、修正のために新しいタグをプッシュして、コミュニティからロールへの信頼を保ち続けてください。

クイックチェック

Galaxyが公開するコードをどこから取得するか思い出してください。

まとめ

ロールのひな形を作成し、meta/main.ymlとREADMEを記入してGitHubにプッシュし、Galaxyにインポートします。Gitのタグがインストール可能なバージョンになります。🚀

よくある質問

「自作 Role を Galaxy に公開する」レッスンは無料ですか？

はい。「自作 Role を Galaxy に公開する」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Ansible Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Ansible Academyコースには全4レッスンが含まれています。

「自作 Role を Galaxy に公開する」で何を学びますか？

自動化を世界中で共有します。 ブラウザで直接実行するハンズオンコードでAnsible Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Ansible Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのAnsible Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。

「自作 Role を Galaxy に公開する」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このAnsible Academyレッスンでコードを書いて実行できますか？

はい。すべてのAnsible Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. Galaxy における Role と Collection
  2. requirements.yml で Role をインストールする
  3. FQCN の利用：namespace.collection.module
  4. 自作 Role を Galaxy に公開する
← Ansible Academyに戻る