2015.07.01

[和訳] パブリックSupermarketインサイドツアー #getchef

この記事は1年以上前に投稿されました。情報が古い可能性がありますので、ご注意ください。

本稿は Public Supermarket: The Insider’s Tour (2015/05/15) の和訳です。

先日、Chef Supermarketのwebinarを開催しました。もし見逃していたなら、こちらで録画を見ることができます。

<br />

ユーザはChef Supermarketをどのように最大活用するかと、Chef SupermarketからCookbookを取得する方法と、Chef SupermarketにCookbookをアップロードする方法の両方のベストプラクティスを学びました。

Supermarketとは何ですか？

Supermarketとは、ChefコミュニティCookbookとツールのための総合サイトです。

現在のSupermarketには2つのバージョンがあることを知っているとよいでしょう。それはパブリックSupermarketサイトと、企業がファイアウォールの背後で使うことのできるプライベートなSupermarketです。

本記事では、パブリックSupermarketについてのみお話しします。プライベートSupermarketの使い方についてのwebinarやブログ記事は近日公開予定です！

Supermarketはどのように使うのですか？

Chef Supermarketとのやりとりには2つの方法があります。

1つはウェブブラウザを通してhttps://supermarket.chef.io/にアクセスする方法です。

もう1つはコマンドライン、knife cookbook siteコマンドを使う方法です。

knife cookbook siteコマンドの使い方について詳しくは、Using Chef Supermarket: A Guided Tour (訳注:和訳)を参照してください。

Contributor License Agreements

コミュニティCookbookなどChef社が保守しているプロジェクトに貢献したいなら、Contributor License Agreementに署名していただく必要があります。Chef社のContributor License Agreementには2種類あります。

ICLA (Individual Contributor License Agreement) -- あなたの個人的な時間を使って個人的な貢献をしたい場合はこちら。
CCLA (Corporate Contributor License Agreement) -- あなたの会社が著作権を保持する作業として貢献をしたい場合はこちら。

Supermarketのアカウントを通して、ユーザ名の横にある矢印からライセンスに署名することができます。それから適切なContributor License Agreementを選択してください。

それから、Githubアカウントへの接続を促されます。CLAに署名するにはGithubアカウントが必要で、Githubアカウントに関連付けられているメールアドレスが、ホステッドChefのアカウントに関連付けられているメールアドレスと一致している必要があります。

ベストプラクティス

SupermarketのCookbookを使うためのベストプラクティス

まずコードを読む -- Supermarketからダウンロードしたコードを使う前に、コードをしっかり読んでください。
客観的な視座を持つ -- そのCookbookはCookbookの作者が抱えていた問題を解決するものであって、あなたの問題を完全には解決しないかもしれないことを念頭に置いてください。しかし、あなたの問題を解決する助けにはなるでしょう。
貢献と引き取りを考える -- ほとんどのCookbookはGithubにあるので、プルリクエストやイシューを受け付けています。ただ、Cookbookのオーナーやメンテナは実在する人間であること、上品に振る舞うことを忘れないでください。もしCookbookがあなたのニーズに合わなくて、Supermarketで「Adopt Me!」というボタンが見えている場合、引き取ることを考えてみてください。

SupermarketのCookbookを共有するためのベストプラクティス

Cookbookのmetadataにsource_urlを含める -- それによって、SupermarketのCookbookのページにソースコードレポジトリへリンクする「View Source」ボタンを表示します。
Cookbookのmetadataにissue_urlを含める -- それによって、SupermarketのCookbookのページにイシュートラッカーへリンクする「View Issues」ボタンを表示します。
Cookbookを養子に出す -- もしCookbookを保守できなくなったり保守したくなくなったりしたら、誰かが保守を引き取れるように養子に出してください。

SupermarketはChefコミュニティのためのもの

Supermarketはオープンソースです！ Githubのプロジェクトを参照してください。Cookbookの保守に参加したいですか？養子リストからCookbookを引き取ることを考えてみてください。

質問

webinarの配信後に寄せられた質問と答えを紹介します。

自分のChef-RepoにあるSupermarketから取得したCookbookを最新に保っておく最適な方法は何ですか？

Chef-Repoを使っているなら、Cookbookを最新に保っておくためにはknife cookbook site installコマンドを使うことを推奨します。Supermarket上のCookbookが変更されたら、knife cookbook site installを実行してください。Chef-Repoに以前のバージョンがあったとしても、Cookbookの最新版のダウンロードとインストールを行います。

knifeコマンドをchef supermarketに変更する予定はありますか？

いいえ。パブリックあるいは(ほとんどの場合)プライベートのSupermarketのどちらかに利用できるKnifeプラグインとして、knife-supermarketがあります。このプラグインを使ったら、knife cookbook siteコマンドよりもknife supermarketコマンドを使うようになるでしょう。

でもknifeコマンドを「chef supermarket」に変更する予定はありません。