開始使用 Red Hat AI InstructLab on IBM Cloud

使用主控台上傳分類系統

完成以下步驟，將您的分類系統儲存於 Object Storage。

1. 從「專案」頁面，選擇您的專案。

2. 按一下分類系統。

3. 按一下上傳，然後輸入下列詳細資訊。

   分類架構檔案

   選擇您的 .tar.gz 檔案。

   分類架構名稱

   為分類系統命名。

   專用儲存庫存取

   如果您的分類學知識文件位於私有 repo 中，請啟用此選項。

   Secrets Manager 服務實例 ：選擇現有的實例或建立一個實例。

   Secrets Manager secret (秘密 )： 選取現有的秘密或建立一個秘密。 如果您要建立秘訣，請選擇「Key-value secret」類型，然後以下列格式加入您的個人存取權標。 請注意 github_url 的值必須包含 https://。 URL 與您在分類系統文件參考 repo 中使用的 URL 相同。

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

   如需詳細資訊，請參閱 建立鍵值秘訣。

   雲端儲存體

   您可以選擇要使用的 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. 可選：如果您使用私有 repo 來儲存分類學知識文件，請完成下列步驟。

   1. 建立服務授權以允許 InstructLab 存取您的 Secrets Manager 範例和機密。

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

   2. 透過建立 Key-value secret，將您的個人存取權標 (PAT) 加入 Secrets Manager。 確保您的鍵值詳細資料以下列格式儲存。

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

      建立 key-value secret 的範例指令。

      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"}}'
      

      如需詳細資訊，請參閱 建立鍵值秘訣。

   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
   

   Example command to use an existing Object Storage instance and bucket as well as Secrets Manager credentials.

   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