Criando um projeto

Em um projetoUma coleção de artefatos que definem e gerenciam recursos e infraestrutura como implementações de código. , você pode adicionar arquiteturas implantáveis do catálogo e editar sua configuração. A implantação de uma configuração a partir de um projeto agrupa recursos com base na configuração que você implantou.

Antes de Iniciar

Os recursos são criados na conta do projeto para o usuário. Você deve ter permissão para criar um projeto e permissão para criar os recursos de ferramentas do projeto dentro da conta. Certifique-se de que você tenha o seguinte acesso:

  • A função de Editor no serviço IBM Cloud Projetos.
  • A função de Editor e Gerente no serviço IBM Cloud® Schematics
  • A função Visualizador no grupo de recursos do projeto

Para obter mais informações sobre acesso e permissões, consulte Atribuir acesso de usuários a projetos.

Adição de usuários a um projeto

O acesso ao projeto é controlado por um IBM CloudIdentity and Access Management (IAM). Você adiciona usuários a um projeto concedendo a função de Leitor ou superior na instância do projeto. Para obter mais informações sobre como atribuir acesso a projetos, consulte Atribuir acesso de usuários a projetos.

Criação de um projeto usando o console

Você pode criar um projeto acessando o Menu de navegação ícone Ícone e selecionando Projetos ou a partir de uma arquitetura implantável no catálogo. Os projetos também podem ser criados usando a API do Projeto.

Adicionando uma arquitetura implantável a um projeto usando o console

As arquiteturas implantáveis que você adiciona a um projeto são representadas como configurações na interface do usuário do projeto. Depois de adicionar uma arquitetura implantável a um projeto, você pode editar sua configuração antes de implantá-la. Existem algumas maneiras de adicionar uma arquitetura implantável ao seu projeto.

Para adicionar uma arquitetura implantável ao seu projeto a partir do painel do projeto, execute as seguintes etapas:

  1. No painel do projeto, selecione a guia Configurações.
  2. Clique em Criar.
  3. Selecione uma arquitetura implantável do catálogo.
  4. Clique em Configurar e implementar.

Você também pode adicionar uma arquitetura implantável a um projeto diretamente do catálogo:

  1. Acesse o catálogo do IBM Cloud.
  2. Selecione a arquitetura implantável.
  3. A partir da lista do catálogo, você pode criar um novo projeto ou adicionar a um já existente.
  4. Clique em Configurar e implementar.

Personalizando uma arquitetura implantável em seu projeto

Dependendo da arquitetura implantável, você poderá personalizá-la ao adicioná-la a um projeto a partir de um catálogo. Você pode ter as seguintes opções:

  • Adicione arquiteturas implantáveis opcionais para expandir a solução para um caso de uso específico.
  • Troque uma arquitetura por outra. Por exemplo, se várias opções de banco de dados forem fornecidas, você poderá selecionar aquela que deseja usar.
  • Selecione uma configuração existente de uma arquitetura em seu projeto para reutilizar com a arquitetura que você está adicionando. Ao fazer isso, você pode reduzir custos e reutilizar a mesma implantação para várias arquiteturas.

Na seção Estender esta arquitetura da lista do catálogo, clique em Personalizar para refinar sua arquitetura antes de configurá-la e implantá-la. Se a opção Personalizar não estiver disponível na lista do catálogo para a arquitetura implantável, você ainda poderá configurar a arquitetura e personalizá-la empilhando outras arquiteturas implantáveis com ela em seu projeto.

Depois de fazer suas seleções e adicionar a arquitetura implantável ao seu projeto, você pode personalizá-la ainda mais selecionando o ícone Opções ícone > Personalizar arquitetura na guia Configurações. A partir daí, você pode adicionar outras arquiteturas implantáveis compatíveis para personalizar ainda mais a solução.

Para fazer backup das informações do projeto fora do serviço IBM Cloud Projetos, você pode exportar o projeto. Para obter mais informações, acesse Projeto JSON.

Confira as etapas sobre como configurar e implantar uma arquitetura implantável quando estiver pronto para implantar recursos de uma arquitetura implantável a partir de um projeto.

Criação de um projeto usando a CLI

Para criar um projeto usando a CLI, execute o seguinte ibmcloud project create comando:

ibmcloud project create [--definition DEFINITION | --definition-name DEFINITION-NAME --definition-destroy-on-delete=DEFINITION-DESTROY-ON-DELETE --definition-description DEFINITION-DESCRIPTION --definition-auto-deploy=DEFINITION-AUTO-DEPLOY --definition-monitoring-enabled=DEFINITION-MONITORING-ENABLED] --location LOCATION --resource-group RESOURCE-GROUP [--configs CONFIGS] [--environments ENVIRONMENTS]

Consulte ibmcloud project create para obter um exemplo de comando e mais informações sobre os parâmetros do comando.

Adicionando arquitetura implantável a um projeto usando a CLI

Para adicionar uma arquitetura implantável ao seu projeto usando a CLI, execute o seguinte ibmcloud project config-create comando:

ibmcloud project config-create --project-id PROJECT-ID [--definition DEFINITION | --definition-compliance-profile DEFINITION-COMPLIANCE-PROFILE --definition-locator-id DEFINITION-LOCATOR-ID --definition-description DEFINITION-DESCRIPTION --definition-name DEFINITION-NAME --definition-environment-id DEFINITION-ENVIRONMENT-ID --definition-authorizations DEFINITION-AUTHORIZATIONS --definition-inputs DEFINITION-INPUTS --definition-settings DEFINITION-SETTINGS --definition-members DEFINITION-MEMBERS --definition-resource-crns DEFINITION-RESOURCE-CRNS] [--schematics SCHEMATICS | --schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN]

Consulte ibmcloud project config-create para obter um exemplo de comando e mais informações sobre os parâmetros do comando.

Para fazer backup das informações do projeto fora do serviço IBM Cloud Projetos, você pode exportar o projeto. Para obter mais informações, acesse Projeto JSON.

Criação de um projeto usando a API

Você pode criar um projeto de forma programática chamando a API de projetos, conforme mostrado na solicitação de exemplo a seguir:

curl -X POST --location --header "Authorization: Bearer {iam_token}" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{ "definition": { "name": "acme-microservice", "description": "A microservice to deploy on top of ACME infrastructure.", "authorizations": { "method": "trusted_profile", "trusted_profile_id": "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12" } }, "configs": [ { "definition": { "name": "account-stage", "description": "The stage account configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global" } }, { "definition": { "name": "env-stage", "description": "The stage environment configuration that includes services common to all the environment regions.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "ref:/configs/account-stage/inputs/account_id", "resource_group": "stage", "access_tags": [ "env:stage" ], "logdna_name": "The name of the LogDNA stage service instance.", "sysdig_name": "The name of the SysDig stage service instance." } } }, { "definition": { "name": "region-us-south-stage", "description": "The stage us-south configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global" } }, { "definition": { "name": "region-eu-de-stage", "description": "The stage eu-de configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "ref:/configs/account-stage/inputs/account_id", "resource_group": "ref:/configs/env-stage/outputs/resource_group_id", "logdna_id": "ref:/configs/env-stage/outputs/logdna_id", "sysdig_id": "ref:/configs/env-stage/outputs/sysdig_id", "access_tags": [ "region:eu-de" ] } } } ], "location": "us-south", "resource_group": "Default" }' \
  "{base_url}/v1/projects"

Adicionando uma arquitetura implantável a um projeto usando a API

Você pode adicionar programaticamente uma arquitetura implantável a um projeto existente chamando a API de projetos e personalizando a configuração, conforme mostrado na seguinte solicitação de exemplo:

curl -X POST --location --header "Authorization: Bearer {iam_token}" \
   --header "Accept: application/json" \
   --header "Content-Type: application/json" \
   --data '{ "definition": { "name": "env-stage", "description": "The stage environment configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "account_id", "resource_group": "stage", "access_tags": [ "env:stage" ], "logdna_name": "LogDNA_stage_service", "sysdig_name": "SysDig_stage_service" } } }' \
   "{base_url}/v1/projects/{project_id}/configs"

Para fazer backup das informações do projeto fora do serviço IBM Cloud Projetos, você pode exportar o projeto. Para obter mais informações, acesse Projeto JSON.