Carregue sua taxonomia usando o console

Conclua as etapas a seguir para armazenar sua taxonomia em Object Storage.

1. Na página Projetos, selecione seu projeto.

2. Clique em Taxonomies (Taxonomias ).

3. Clique em Upload e insira os seguintes detalhes.

   Arquivo de taxonomia

   Selecione seu arquivo .tar.gz.

   Nome da taxonomia

   Dê à taxonomia um nome alfanumérico.

   Acesso ao repositório privado

   Ative essa opção se os documentos de conhecimento da taxonomia estiverem em um repositório privado.

   Secrets Manager instância de serviço: Selecione uma instância existente ou crie uma.

   Secrets Manager secret: Selecione um segredo existente ou crie um. Se estiver criando um segredo, selecione o tipo de segredo Key-value e adicione seu token de acesso pessoal no seguinte formato. Observe que o valor de github_url deve conter https://. O URL é o mesmo URL que você usou na seção repo da referência do seu documento de taxonomia.

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

   Para obter mais informações, consulte Criação de segredos de valores-chave.

   Armazenamento em nuvem

   Selecione uma instância e um bucket de Object Storage para usar ou crie uma instância e um bucket.

   Autorização de serviço

   Marque a caixa para permitir que o InstructLab escreva sua taxonomia em Object Storage

   Configurações de armazenamento opcionais

   Especifique o caminho onde você deseja armazenar a taxonomia tar.gz em Object Storage.

4. Clique em Upload

Adicione a taxonomia a Object Storage usando a CLI

Conclua as etapas a seguir para armazenar sua taxonomia em Object Storage.

Você pode usar o comando set para salvar os detalhes e as credenciais do bucket Object Storage e muito mais. Isso pode simplificar seus comandos no futuro. Observe que, ao usar o comando set, você deve definir cada valor individualmente. Para obter mais informações, consulte a referência do comando Config.

1. Faça login na sua conta IBM Cloud na CLI.

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

2. Se você planeja permitir que o InstructLab crie recursos de instância IBM Cloud® Object Storage para você, direcione um grupo de recursos.

   ibmcloud target -g <resource_group>
   

   Exemplo:

   ibmcloud target -g Default
   

1. Crie a política de autorização para InstructLab e Object Storage.

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

2. Opcional: se você estiver usando um repositório privado para armazenar seus documentos de conhecimento de taxonomia, conclua as etapas a seguir.

   1. Crie uma autorização de serviço para permitir que o InstructLab acesse a instância e os segredos do Secrets Manager.

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

   2. Adicione seu token de acesso pessoal (PAT) a Secrets Manager criando um segredo de valor-chave. Certifique-se de que seus detalhes de valor-chave estejam armazenados no seguinte formato.

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

      Exemplo de comando para criar um segredo de valor-chave.

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

      Para obter mais informações, consulte Criação de segredos de valores-chave.

   3. Liste suas instâncias de Secrets Manager.

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

   4. Obtenha os detalhes de sua instância.

      ibmcloud resource service-instance INSTANCE
      

3. Execute o comando taxonomy add --help e examine as opções de comando.

   ibmcloud ilab taxonomy add --help
   

4. Opcional Se você tiver uma instância existente do Object Storage que deseja usar, obtenha os detalhes da instância do serviço.

   1. Liste suas instâncias de Object Storage.

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

   2. Obtenha os detalhes de sua instância.

      ibmcloud resource service-instances INSTANCE
      

5. Adicione sua taxonomia ao seu bucket Object Storage. Analise os seguintes comandos de exemplo.

   Início rápido Exemplo de comando para criar automaticamente uma instância e um bucket Object Storage em sua conta e fazer upload de uma taxonomia da pasta ./taxonomy para ela.

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

   Exemplo de comando para fazer upload de uma taxonomia de uma pasta taxonomy em seu computador para uma instância e um bucket existentes em 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
   

   Exemplo de comando para usar uma instância e um bucket existentes do Object Storage, bem como as credenciais do 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
   

   Exemplo de comando para fazer upload de uma taxonomia da pasta /Users/USER/instructlab-taxonomy para um novo bucket criado automaticamente.

   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