Importando uma versão no seu catálogo privado

Conclua as etapas a seguir para importar uma versão de seu software no seu catálogo privado. Seu catálogo privado foi criado para você como parte de Configurando para vender software.

1. No console do IBM Cloud, clique no ícone “ Menu de navegação ” ( ) > “ Central de Parceiros ” > “ Meus produtos ”.

2. Selecione o produto que está sendo integrado.

3. Na guia Software, clique em Importar uma versão.

4. Selecione seu método de implementação.

5. Selecione se você está incluindo seu produto de um repositório privado ou público. Para os operadores, selecione seu repositório de origem e, em seguida, escolha repositório privado ou público.

6. Insira sua URL de origem.

   É possível revisar a lista a seguir de formatos suportados por tipo de software:

   • Gráfico Helm: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
   • Operador Node-Red: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
   • Pacote de operadores de um registro do Red Hat OpenShift on IBM Cloud: Para ver um exemplo, selecione o Akka Cluster Operator na lista de operadores disponíveis no repositório certificado.
   • Imagem do OVA: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
   • Modelo do Terraform: https://github.com/IBM-Cloud/terraform-sample/archive/refs/tags/v1.1.0.tar.gz.
   • Imagem do servidor virtual com Terraform: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
   • Imagem do servidor virtual para VPC: selecione uma imagem na lista de imagens disponíveis que foram importadas para sua VPC ou importe uma nova imagem para sua conta.

   Uma imagem do servidor virtual para VPC só pode ser incluída em um produto dentro de um catálogo privado por vez, Se a imagem do servidor virtual que você deseja importar já estiver importada para outro produto, você deverá remover a imagem desse produto ou excluir o produto antes de incluir a imagem do servidor virtual em um novo produto.

   Se você estiver incluindo seu produto de um repositório privado, será possível optar por fornecer um token de acesso pessoal ou usar um segredo. Em vez de dar aos usuários um token de acesso pessoal, é possível fornecer a eles acesso a um segredo, incluir o token em um segredo e gerenciar centralmente todos os tokens e o acesso que o segredo permitir.

   Se o seu software estiver localizado em, GitLab, você deve usar um token de acesso pessoal, pois GitLab não suporta o download de versões usando tokens de acesso ao projeto. Você pode criar um token de acesso pessoal com a permissão " read_api necessária seguindo as instruções aqui.

   • Se você estiver usando um token de acesso pessoal, selecione Não para indicar que você não está usando um segredo e forneça o seu token de acesso pessoal.
   • Se você estiver usando um segredo, selecione Sim e clique em Selecionar do Secrets Manager. Selecione sua instância de serviço, seu grupo de segredos e seu segredo. Se seu segredo não for exibido, certifique-se de que você esteja usando o grupo de segredos e a instância de serviço corretos.

   A mensagem No service instance available poderá ser exibida se você não tiver criado um segredo ou não tiver o acesso correto para usar segredos, mesmo que você tenha instâncias de serviço criadas.

7. Se aplicável, configure seu destino de implementação e inclua sua versão de software.

8. Clique em Incluir versão.

Configurando os detalhes da versão

1. Na lista de versões, clique na linha que contém seu software.
2. Revise os detalhes da versão e clique em Avançar.
3. Dependendo do seu tipo de software, pode ser necessário realizar etapas adicionais, incluindo a configuração de valores de implementação.
4. Clique em Avançar.

Incluindo contratos de licença

Se os usuários forem obrigados a aceitar quaisquer acordos de licença além do Acordo de Serviços da IBM Cloud ao instalar o software, forneça a URL a todos os acordos ou licenças de importação de uma versão existente.

Revisando seu arquivo leia-me

Quando os usuários instalam o software, eles podem visualizar as informações do produto clicando no link Leia-me. As informações contidas no link “Readme” são geradas a partir do arquivo “readme” que você enviou para o seu repositório de código-fonte.

1. A partir da aba Editar do leia-me, clique no ícone Editar .
2. Visualize como as informações no arquivo leia-me serão exibidas para os usuários quando eles estiverem instalando o software.
3. Para fazer atualizações, clique no ícone Editar ao lado do título da seção Leia-me.
4. Clique em Salvar.
5. Clique em Avançar.

Se estiver importando uma imagem do servidor virtual para VPC, o arquivo leia-me não será gerado automaticamente. Copie e cole o conteúdo do modelo de arquivo leia-me e faça atualizações, conforme necessário

Validando o produto

As etapas para validar o seu produto podem variar com base no tipo de software que você está integrando.

1. Na guia Validar produto, configure seu destino de validação e clique em Avançar. Esta etapa se aplica apenas a gráficos e Operadores Helm.
2. Configure sua área de trabalho e clique em Avançar. Esta etapa se aplica apenas a gráficos do Helm, Operadores, modelos Terraform e imagens de servidor virtual com o Terraform.
3. Clique em Validar.

Para monitorar o progresso do processo de validação, clique em Visualizar logs.

Validando seu software usando a API

É possível validar seu software chamando a API do Catalog Management.

String authRefreshToken = "{authRefreshToken}";
String versionLocator = "{versionLocator}";
ValidationInstallOptions installOptions = new ValidationInstallOptions.Builder().xAuthRefreshToken(authRefreshToken).versionLocId(versionLocator).build();
Response<Void> response = service.validationInstall(installOptions).execute();
System.out.println(response.getResult());

versionLocator = "{versionLocator}";
authRefreshToken = "{authRefreshToken}";
response = await service.validationInstall({ 'versionLocatorId': versionLocator, 'xAuthRefreshToken': authRefreshToken });
console.log(response);

authRefreshToken="{authRefreshToken}"
versionLocator = "{versionLocator}"
response = self.service.validation_install(version_locator_id=versionLocator, x_auth_refresh_token=authRefreshToken)
print(response)

versionLocator := "{versionLocator}"
authRefreshToken := "{authRefreshToken}"
installOptions := service.NewValidationInstallOptions(versionLocator, authRefreshToken)
response, _ := service.ValidationInstall(installOptions)
fmt.Println(response)

Gerenciamento de controles de segurança e conformidade

Os controles são proteções usadas para atender aos requisitos de segurança e conformidade. Apenas os controles compatíveis com Workload Protection aparecem no catálogo. Para obter mais informações, consulte Formatação de controles em seu arquivo leia-me