コンソールを使ってタクソノミーをアップロードする

Object Storage にタクソノミーを保存するには、以下の手順を実行します。

1. プロジェクトの ページから、プロジェクトを選択します。

2. 「分類」 をクリックします。

3. アップロードをクリックし、以下の詳細を入力する。

   分類ファイル

   .tar.gz ファイルを選択してください。

   分類名

   分類法に英数字の名前をつける。

   プライベート・リポジトリへのアクセス

   タクソノミ・ナレッジ・ドキュメントがプライベート・リポジトリにある場合、このオプションを有効にします。

   Secrets Manager サービスインスタンス ：既存のインスタンスを選択するか、インスタンスを作成します。

   Secrets Manager secret: 既存のシークレットを選択するか、作成します。 シークレットを作成する場合は、 Key-Value シークレットタイプを選択し、以下の形式で個人アクセストークンを追加します。 なお、 github_url の値は、https:// を含んでいなければならない。 URL は、タクソノミーのドキュメント・リファレンスの repo セクションで使用したのと同じ URL です。

   {
   "github_url": "https://...",
   "github_pat": "xxxxx"
   }
   

   詳細については、 Key-value シークレットの作成 を参照のこと。

   クラウド・ストレージ

   使用する Object Storage インスタンスとバケットを選択するか、インスタンスとバケットを作成する。

   サービス許可

   InstructLab にあなたのタクソノミーを書き込むことを許可するボックスにチェックを入れる。 Object Storage

   オプションのストレージ設定

   Object Storage のタクソノミー tar.gz を保存するパスを指定します。

4. アップロードをクリック

CLIを使用して、 Object Storage にタクソノミーを追加します

Object Storage にタクソノミーを保存するには、以下の手順を実行します。

set コマンドを使って、 Object Storage バケツの詳細や認証情報などを保存することができます。 これにより、今後のコマンドを簡素化することができる。 set コマンドを使用する場合は、各値を個別に設定する必要があることに注意。 詳細については、 Configコマンドのリファレンスを 参照してください。

1. CLIから IBM Cloud アカウントログインする。

   ibmcloud login -a https://cloud.ibm.com --sso -r us-east
   

2. InstructLab に IBM Cloud® Object Storage Instance リソースを作成させる場合は、リソースグループをターゲットにします。

   ibmcloud target -g <resource_group>
   

   次に例を示します。

   ibmcloud target -g Default
   

1. InstructLab と Object Storage の認可ポリシーを作成する。

   ibmcloud iam authorization-policy-create Writer --source-service-name instructlab --target-service-name cloud-object-storage
   

2. オプション ： プライベート・レポを使用してタクソノミ・ナレッジ・ドキュメントを保存している場合は、以下の手順を実行します。

   1. Secrets Manager インスタンスとシークレットへのアクセスを InstructLab に許可するサービス認可を作成します。

      ibmcloud iam authorization-policy-create Reader --source-service-name instructlab --target-service-name secrets-manager
      

   2. Key-value シークレットを作成し、 Secrets Manager にパーソナル・アクセストークン（PAT）を追加します。 キー・バリューの詳細が以下のフォーマットで保存されていることを確認してください。

      {
      "github_url": "https://...",
      "github_pat": "xxxxx"
      }
      

      キー・バリューの秘密を作成するコマンドの例。

      ibmcloud secrets-manager secret-create --secret-prototype='{"name": "my-secret","description": "Description of my key-value secret.","secret_type": "kv","secret_group_id": "67d025e1-0248-418f-83ba-deb0ebfb9b4a","labels": ["dev","us-south"],"data": {"github_url": "https://...","github_pat": "xxxxx"},"custom_metadata": {"metadata_custom_key": "metadata_custom_value"},"version_custom_metadata": {"custom_version_key": "custom_version_value"}}'
      

      詳細については、 Key-value シークレットの作成 を参照のこと。

   3. Secrets Manager インスタンスをリストアップしてください。

      ibmcloud resource service-instances --service-name secrets-manager
      

   4. インスタンスの詳細を取得します。

      ibmcloud resource service-instance INSTANCE
      

3. taxonomy add --help コマンドを実行し、コマンドオプションを確認する。

   ibmcloud ilab taxonomy add --help
   

4. オプション使用したい既存の Object Storage インスタンスがある場合は、サービスインスタンスの詳細を取得します。

   1. Object Storage インスタンスをリストアップしてください。

      ibmcloud resource service-instances --service-name cloud-object-storage
      

   2. インスタンスの詳細を取得します。

      ibmcloud resource service-instances INSTANCE
      

5. タクソノミーを Object Storage バケツに追加します。 以下のコマンド例を見てみよう。

   クイックスタート アカウントに Object Storage インスタンスとバケットを自動的に作成し、 ./taxonomy フォルダからタクソノミーをアップロードするコマンド例です。

   ibmcloud ilab taxonomy add \
   --name example-taxonomy-1 \
   --taxonomy-path "./taxonomy"
   

   マシンの taxonomy フォルダから既存の Object Storage インスタンスとバケットにタクソノミーをアップロードするコマンドの例。

   ibmcloud ilab taxonomy add \
   	--name example-taxonomy-name-1 \
   	--taxonomy-path-cos "taxonomies/taxonomy.tar.gz" \
   	--taxonomy-path "./taxonomy" \
   	--cos-bucket example-cloud-object-storage-bucket-1 \
   	--cos-endpoint https://s3.us-east.cloud-object-storage.appdomain.cloud
   

   既存の Object Storage インスタンスとバケット、および Secrets Manager 認証情報を使用するコマンド例。

   ibmcloud ilab taxonomy add \
   --name example-taxonomy-1 \
   --taxonomy-path-cos taxonomies/taxonomy.tar.gz \
   --taxonomy-path "./taxonomy" \
   --cos-endpoint https://s3.us-east.cloud-object-storage.appdomain.cloud \
   --secrets-manager-git-id SEC-MGR-ID
   --secrets-manager-git-url https://URL
   

   タクソノミーを /Users/USER/instructlab-taxonomy フォルダから新しい自動作成されたバケツにアップロードするコマンドの例です。

   ibmcloud ilab taxonomy add \
   --name test \
   --taxonomy-path "/Users/USER/instructlab-taxonomy" \
   --cos-endpoint https://s3.us-east.cloud-object-storage.appdomain.cloud \
   --cos-id 628e4348-2183-42fa-a03a-6f0f78453530