サンプル リポジトリの設定

サンプル リポジトリは、チームがアプリケーション開発に使用できるカスタム サンプルを含む Git リポジトリです。

つまり、組織またはチーム内で、組織向けに Cloud Code でサンプル リポジトリを設定して、他のユーザーが使用できる標準のスターター アプリケーション、サービス、インフラストラクチャ構成をまとめて提供できます。これにより、新しいプロジェクトが組織推奨の技術スタックと標準に合わせて表示され、開発サイクルの開始時にベスト プラクティスが組み込まれます。

サンプル リポジトリは、すでに作成したサンプル アプリケーションの既存のリポジトリであったり、他の人に使ってもらいたいテサンプル新のしいセットであったりします。Cloud Code でインポートする場合、サンプル記述子ファイルをリポジトリに追加するだけで実行できます。

準備ができたらサンプル リポジトリはチームで簡単に共有できます。Cloud Code の設定と、使用するサンプル リポジトリの Git URL が必要です。プライベート Git リポジトリでは、そのリポジトリにアクセスできるメンバーだけが基礎となるカスタム サンプルを使用できます。

サンプル リポジトリの設定例については、このリポジトリをご覧ください。

新しいサンプル リポジトリの作成

新しいサンプル リポジトリを作成する場合は、次の手順を行います。

  1. 新しい Git リポジトリを作成する。

    Git リポジトリは、リモートまたはローカルマシンでホストできます。この例では、新しい GitHub リポジトリ「custom-sample-repo」を使用します。

    リポジトリ名が「custom-sample-repo」である GitHub リポジトリ作成インターフェース

  2. このリポジトリにサンプル ディレクトリを追加する。

    サンプル ディレクトリには、任意の情報を含めることができ、リポジトリ内の任意の場所に配置できます。この例では、2 つのサンプル ディレクトリ「hello-world」と「kubernetes-custom-sample」が「custom-sample-repo」に追加されました。

    カスタム サンプルの使用方法が解説されている readme ファイルを使用することを強くおすすめします。

    「hello-world」と「kubernetes-custom-sample」という 2 つの基本サンプル ディレクトリが存在する「custom-sample-repo」

  3. サンプル記述子ファイルを作成する

    サンプル記述子ファイルは、アプリケーションを適切に作成するためのサンプルに関する情報を Cloud Code に提供します。このファイルには、ルート ディレクトリにある .cctemplate という名前が付けられ、サンプル記述子ファイル スキーマ セクションで定義されているスキーマが必要です。

既存のリポジトリの使用

既存のリポジトリを使用する場合も、サンプル記述子ファイルを作成する必要があります。このファイルは、アプリケーションを適切に作成するためのサンプルに関する情報を Cloud Code に提供します。

サンプル記述子ファイルには、ルート ディレクトリにある .cctemplate という名前が付けられ、サンプル記述子ファイル スキーマ セクションで定義されているスキーマが必要です。

サンプル記述子スキーマ

説明
メタデータ Cloud Code が読み取りに使用するメタデータ。メタデータ スキーマに準拠します。 メタデータ
テンプレート リポジトリに含まれるサンプルの配列。 この配列内のオブジェクトは、サンプル スキーマに準拠している必要があります。 Array<Sample>
名前(省略可) サンプル リポジトリの名前。 String(文字列)

{
   "metadata":{
      "version":"1"
   },
   "name": "My Sample Repository",
   "templates":[
      {
         "path":"/path/to/sample1_location",
         "name":"My Sample 1",
         "description":"The first sample of its name."
      },
      {
         "path":"/path/to/sample2_location",
         "name":"My Sample 2",
         "description":"The sequel."
      }
   ]
}

サンプル スキーマ

説明
パス サンプルがリポジトリ内のどこに配置されるか。

このパスは、リポジトリのルートからのものとして解釈されます。

String(文字列)
名前 サンプルの名前。

これは、アプリケーションをベースとするサンプルを選択した場合に、IDE に表示されます。

String(文字列)
説明(省略可) サンプルの説明。

これは、アプリケーションをベースとするサンプルを選択した場合に、IDE に表示されます。

String(文字列)

{
   "path":"path/to/sample1",
   "name":"My Sample 1",
   "description":"The first sample of its name."
}

メタデータ スキーマ

説明
バージョン 使用されているサンプル スキーマのバージョン。現時点で有効なバージョンは 1 のみです。 String(文字列)

{
   "version":"1"
}

サポートの利用

フィードバックを送信するには、GitHub で問題を報告します。または、Stack Overflow で質問します。