Movendo recursos de uma área de trabalho do Schematics para um projeto

É possível gerenciar o ciclo de vida de uma arquitetura corporativa movendo recursos de um projeto Área de trabalho IBM Cloud® Schematics para um projeto IBM Cloud® Embora seja possível usar uma área de trabalho do Schematics para usar o Terraform e arquiteturas implementáveis, é possível usar um projeto para gerenciar o ciclo de vida completo em escala. Após concluir essa tarefa, você terá um ladrilho de arquitetura implementável em seu catálogo privado e poderá gerenciar o ciclo de vida da arquitetura implementável por meio de um projeto.

Durante esse processo, é possível usar os comandos da CLI ibmcloud catalog utility create-product-from-workspace e ibmcloud project config-create para criar um catálogo e um projeto vinculados e, em seguida, mover os recursos da área de trabalho Schematics para o projeto.

Observe e aprenda o processo de mover recursos implementados para um projeto.

Assista e aprenda

Transcrição de vídeo

Eu sou Gili Mendel, um STSM com a equipe de desenvolvimento do IBM Cloud. Vou mostrar como mover uma área de trabalho do Schematics na arquitetura implementável ou em um projeto do IBM Cloud.

Uma área de trabalho Schematics é a maneira como você executa uma automação do Terraform no IBM Cloud. A área de trabalho contém um link para um repositório Git do qual ele busca o modelo do Terraform. Ele também contém a variável de modelo e o estado dos recursos conforme ele a cria

É uma ótima maneira de executar a automação do Terraform IaaS na nuvem sem manter um depósito do IBM Cloud® Object Storage altamente disponível para o estado com as integrações íntimas para provedores de recursos em nuvem.

No entanto, essa abordagem não será escalada se você estiver conduzindo várias automações. Gerenciar os recursos e rolar uma nova versão do modelo pode ser uma tarefa assustadora.

Embora uma empresa aproveita a automação do Terraform, é tudo sobre arquiteturas implementáveis. Você publica uma arquitetura de referência, com uma designação de área de cobertura de conformidade, estimativas de custos e um modelo Terraform que automatiza a implementação da arquitetura.

O repositório Git é usado para iterar e construir a arquitetura e suas automações.. Ele pode ou não estar visível para os usuários que implementam a arquitetura A própria arquitetura tem um ciclo de vida que inclui atualizações de versão.

Etapa 1: use a CLI de gerenciamento de Catálogos para criar uma arquitetura implementável a partir da área de trabalho existente e o ciclo de vida necessário para publicar as novas versões para ela.

Etapa 2: Use a CLI do Projeto para modificar a área de trabalho para que ela seja gerenciada como uma arquitetura implementável por um projeto. Como tal, esses recursos podem ser tratados como uma configuração de versão de arquitetura implementável única e podem ser gerenciados a partir de uma conta de administrador em vários ambientes A migração de versão, o custo e a área de cobertura de conformidade são mais simples e estão todos envolvendo a arquitetura implementada.

Antes de Iniciar

Certifique-se de que a área de trabalho IBM Cloud® Schematics seja criada e os recursos sejam provisionados em sua conta. O projeto e a área de trabalho devem estar na mesma conta
Defina uma variável de ambiente GIT_TOKEN para se autenticar em seu repositório de origem Git. Por exemplo, execute export GIT_TOKEN="enter your GIT TOKEN".. O token precisa de permissão para concluir essas tarefas relacionadas Git à medida que você move recursos implantados para seu projeto.
Configure um método de autenticação para conectar o projeto ao catálogo. É possível usar um dos métodos a seguir:
- Configure a variável de ambiente IC_API_KEY para acessar sua conta do IBM Cloud. Por exemplo, execute IC_API_KEY="Your API key"..
- Use os detalhes do trusted-profile-id para acessar a conta do IBM Cloud. Para obter mais informações, consulte Localizando o ID do perfil confiável. Por exemplo, um ID de perfil confiável pode ser semelhante a Profile-1bd5eala-000-4a6666-00000
Certifique-se de que os plug-ins da CLI Projeto e Gerenciamento de catálogos estejam atualizados. Execute o comando ibmcloud plugin list para visualizar a versão atual dos plug-ins da CLI.
Crie um projeto para implementação de produção e registre o nome e o ID do projeto no qual você deseja mover os recursos.
Certifique-se de que o serviço de Projetos esteja autorizado em sua conta para se comunicar com outros serviços IBM Cloud. Para obter mais informações, consulte Concedendo acesso entre o serviço de Projetos e outros IBM Cloud serviços.

Criando uma arquitetura implementável a partir de uma área de trabalho Schematics

Ignore esta seção se você já tiver uma arquitetura implementável em sua área de trabalho do Schematics.

Se você tiver implementado o software usando uma área de trabalho do Schematics ou por meio de um catálogo privado, será possível mover os recursos implementados para um projeto usando o comando ibmcloud catalog utility create-product-from-workspace.

O comando executa as seguintes tarefas relacionadas ao Git:

Clona o repositório de arquitetura implementável..
Envia por push o arquivo de manifesto ibm_catalog.json para uma nova ramificação
Cria um diagrama de arquitetura de item temporário (architecture-diagram-placeholder.drawio.svg).
Cria uma liberação Git no repositório.
Fornece o ativo de versão URL.

O comando também executa as seguintes tarefas relacionadas ao IBM Cloud:

Cria um catálogo privado no IBM Cloud.
Cria um projeto no qual você faz desenvolvimento e teste.
Vincula o projeto e o catálogo usando um ID de perfil confiável ou uma chave API.
Cria o ladrilho de produto no catálogo privado
Onboard a versão do produto para o novo catálogo privado
Marca a versão como pronta para ser compartilhada
Conclui a integração da área de trabalho e da arquitetura implementável, movendo a área de trabalho para o catálogo
Mostra o ID do projeto, ID do catálogo, ID da oferta e localizador de versão.

Conclua as seguintes etapas para criar uma arquitetura implementável e mover todos os recursos implementados para uma configuração de projeto:

Execute o comando ibmcloud catalog utility create-product-from-workspace..

ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]

--api-key e --trusted-profile-id são mutuamente exclusivos. Você precisa de apenas um ou outro. O parâmetro --project-name cria o projeto no qual você faz desenvolvimento e teste. Você pode desejar nomeá-lo da mesma forma que seu ID da área de trabalho para simplicidade.

Veja o exemplo a seguir das opções de comandos do utility create-product-from-workspace

ibmcloud catalog utility create-product-from-workspace --workspace-id us-south.workspace.move.xxxx --api-key $IC_API_KEY --catalog-label myCatalog --offering-label myOffering --project-name myProject --project-resource-group Default --target-version 1.0.0 --variation-label test_standard

Quando a execução do comando for concluída, o prompt de comandos retornará OK

Verifique os resultados no Git visualizando a confirmação, o repositório e a nova liberação.. É possível ver o arquivo .tgz com versões.
Verifique os resultados no console do IBM Cloud:
1. Acesse Gerenciar > Catálogos > Catálogos privados.
2. Selecione o novo catálogo privado
3. Selecione o novo produto em seu catálogo privado e, em seguida, selecione a guia Versões Veja se você tem a versão 1.0.0 (ou semelhante) de sua arquitetura implementável.. Se você acessar seu catálogo privado, verá a mesma arquitetura implementável em um bloco.
4. Clique no ícone Menu Navegação > Projetos e veja o novo projeto.
5. Selecione a guia Configurações para ver a arquitetura implementável.. Veja se ele está no status draft

Criando a configuração do projeto.

O comando ibmcloud project config-create cria uma configuração de projeto que faz a área de trabalho Schematics ser executada em um projeto no qual é possível criar outra versão do projeto e modificar a arquitetura implementável, conforme necessário.

Antes de iniciar esta seção, certifique-se de ter uma arquitetura implementável em um catálogo privado e uma área de trabalho Schematics em execução e conhecer seu CRN. É possível localizar o CRN da área de trabalho na lista de recursos no console do IBM Cloud ou usando a CLI.

Console do IBM Cloud: no console do IBM Cloud, clique no Menu de navegação ícone > Lista de recursos. > Ferramentas do desenvolvedor > e copie o CRN.
IBM Cloud CLI: execute o comando ibmcloud schematics workspace get para buscar os detalhes do CRN da área de trabalho. Por exemplo, execute ibmcloud schematics workspace get --id workspace-id --output destination folder --json output.json para buscar os detalhes do CRN da área de trabalho Schematics.

Conclua as etapas a seguir para incluir uma configuração de projeto e mover os recursos da área de trabalho Schematics para o projeto:

Execute o comando ibmcloud project config-create
```
ibmcloud project config-create --project-id PROJECT-ID [--schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN] [--definition-name DEFINITION-NAME] [--definition-locator-id DEFINITION-LOCATOR-ID]
```
O valor de --project-id é a ID do projeto que você criou para a implantação de produção na etapa Antes de começar. O valor para --definition-locator-id é o mesmo que o localizador de versão da seção anterior.

Veja o exemplo a seguir de opções de comandos do project config-create
```
ibmcloud project config-create --project-id myProdProject --schematics-workspace-crn MyWorkspaceCRN --definition-name production-deployment --definition-locator-id myVersionLocator
```
Quando a execução do comando for concluída, o prompt de comandos retornará o nome, o estado e o tipo.
Verifique se seus modelos do Terraform estão implementados em seu projeto:
1. No console do IBM Cloud, clique no ícone Menu de navegação > Projetos.
2. Selecione seu projeto que você primeiro criou para a produção de implementação e acesse a guia Configurações.
3. Clique no ícone Ações > Visualizar a última implementação
4. Na seção Implementação bem-sucedida, clique em Mudanças implementadas com sucesso > Logs para visualizar todos os recursos implementados no projeto.

A implementação da área de trabalho Schematics agora está incluída nos logs que estão dentro do novo projeto.

Se você desejar verificar os resultados usando a CLI, execute os comandos ibmcloud project get ou ibmcloud project list para verificar se sua área de trabalho foi movida com êxito para seu projeto.

Próximas etapas

Para concluir o restante do processo para a arquitetura implementável, conclua as etapas a seguir:

Configure os detalhes da implementação para a arquitetura implementável
Defina o acesso do IAM
Inclua um diagrama de arquitetura, pré-requisitos e destaques.
Incluir informações de conformidade (controles).
Revalidar para receber uma estimativa de custo

Para obter mais informações sobre como concluir as etapas, consulte Onboarding de uma arquitetura implementável customizada para seu catálogo privado

Para obter mais informações, consulte Adotando a arquitetura corporativa.