Modelar e empacotar unidades de implantação

Pré-lançamento

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Esta página descreve como modelar e empacotar unidades de implantação para uma oferta de SaaS. No ambiente de execução de SaaS, uma unidade de implantação é chamada de tipo de unidade.

Crie um tipo de unidade para cada componente da oferta de SaaS que você quer gerenciar de forma independente. Para mais detalhes, consulte a seção Determinar o modelo da oferta de SaaS.

Se quiser, você pode criar uma oferta de SaaS usando um único tipo de unidade para toda a oferta.

Os tipos de unidades são definidos por um blueprint, que é uma configuração do Terraform empacotada como uma imagem OCI. Antes de criar um tipo de unidade, é necessário ter um blueprint criado para cada tipo. Para detalhes sobre como criar projetos, consulte Criar e fazer upload de um projeto.

Antes de começar

1. Defina uma oferta de SaaS para seu aplicativo SaaS.
2. Verifique se você criou um repositório do Artifact Registry.
3. Verifique se você tem as contas de serviço com as permissões necessárias. Para mais detalhes, consulte Contas de serviço do ambiente de execução do SaaS.
4. Para cada tipo de unidade que você está criando, verifique se tem uma configuração do Terraform e se preparou o blueprint. Para mais detalhes, consulte a seção Determinar o modelo da oferta de SaaS.

Determine o modelo da oferta de SaaS

Para modelar a oferta de SaaS, você precisa determinar quantos tipos de unidades criar e a relação entre eles.

Por exemplo, é possível criar dois tipos de unidade: um para a infraestrutura, como uma VM, e outro para o aplicativo implantado na infraestrutura. Se quiser, crie uma oferta de SaaS usando um único tipo de unidade para toda a oferta.

Para decidir como modelar a oferta de SaaS usando tipos de unidade, considere o seguinte:

• Revise as dependências entre os componentes da oferta de SaaS. Por exemplo, se uma oferta de SaaS incluir um aplicativo implantado em um cluster compartilhado do Kubernetes, considere usar um tipo de unidade para modelar esse cluster compartilhado.
• Considere o ciclo de lançamento e manutenção dos componentes da oferta de SaaS. Se houver componentes gerenciados juntos, como a infraestrutura, considere modelar esses componentes com um tipo de unidade.

Depois de determinar esse modelo, crie um blueprint para cada tipo de unidade. Para isso, faça o seguinte:

1. Identifique a configuração do Terraform para se conectar a esse tipo de unidade. Para mais detalhes sobre as configurações do Terraform necessárias, consulte Blueprints no ambiente de execução do SaaS.
2. Verifique se a configuração do Terraform está empacotada como uma imagem OCI e enviada para o Artifact Registry ou se está em um arquivo ZIP ou repositório Git. Para mais detalhes, consulte Criar e fazer upload de um blueprint.

Quando você tiver um blueprint para cada tipo de unidade, siga as instruções nesta página para criar os tipos de unidade.

Criar um tipo de unidade

É possível criar um tipo de unidade usando uma configuração do Terraform fornecida das seguintes maneiras:

• Em um arquivo ZIP.
• Em um repositório Git.
• Empacotado como uma imagem OCI.

Criar um tipo de unidade usando um arquivo ZIP

Para criar um tipo de unidade usando uma configuração do Terraform em um arquivo ZIP, siga estas instruções.

Para detalhes sobre como preparar um arquivo ZIP, consulte Fazer upload de um arquivo ZIP.

Para criar um tipo de unidade:

1. No console, acesse SaaS Runtime > Tipos de unidades.

   Acessar "Tipos de unidades"

2. Selecione Criar.

3. Em Criar blueprint, selecione Fazer upload para enviar um arquivo ZIP que contenha a configuração do Terraform.

   1. Clique em Procurar e encontre o arquivo ZIP com a configuração do Terraform que define os recursos ou o aplicativo que faz parte desse tipo de unidade.

   2. Clique em Próxima: configurar blueprint.

4. Na página Armazenar blueprint:

   1. Em Selecionar repositório do Artifact Registry, clique em Procurar e selecione o repositório que você criou.

   2. Em Nome da imagem do artefato, insira um nome para a imagem OCI.

   3. Em Versão do Terraform do Infrastructure Manager, selecione a versão do Terraform a ser usada para implantações. Para conferir uma lista de versões compatíveis do Terraform, consulte Versões compatíveis do Terraform.

   4. Para a conta de serviço do Cloud Build, selecione a conta de serviço que tem as permissões para criar a imagem. Para mais detalhes, consulte Conta de serviço de criação de artefatos.

   5. Clique em Próxima: detalhes do tipo de unidade.

5. Na página Configurar propriedades do tipo de unidade, faça o seguinte:

   1. Em Nome do tipo de unidade, insira um nome para o tipo de unidade. O nome precisa conter apenas letras minúsculas, números ou hifens.

   2. Em Oferta de SaaS, selecione a oferta que você quer associar a esse tipo de unidade.

   3. Para Dependências:

      • Se esta for a primeira ou única unidade que você está criando para a oferta de SaaS, não adicione uma dependência.

      • Se você criou outros tipos de unidades que dependem deste, selecione Adicionar dependência.

        1. Em Tipo de unidade, selecione o tipo de unidade existente que depende do tipo que você está criando.

        2. Em Alias, digite um nome que possa ser usado para mapeamento de variáveis de entrada.

        3. Clique em Concluído.

        4. Se quiser definir o mapeamento de variáveis, siga estas etapas. Para mais detalhes sobre o mapeamento de variáveis, consulte Mapeamento de variáveis.

           1. Selecione Definir mapeamentos de variáveis de entrada e saída.

           2. Para Mapeamentos de variáveis de entrada:

              1. Selecione Adicionar mapeamento de variáveis de entrada.
              2. Em Variável, digite o nome da variável de entrada.
              3. Em Tipo de mapeamento, selecione:
                 • De para mapear do outro tipo de unidade.
                 • Para mapear para o outro tipo de unidade.
              4. Em Dependência, selecione o tipo de unidade existente a que você está mapeando variáveis.
              5. Em Variável de saída, digite o nome da variável de saída.
              6. Selecione Concluído.

           3. Para adicionar outra variável de entrada, selecione Adicionar mapeamento de variáveis de entrada e repita as etapas.

           4. Para adicionar mapeamentos de variáveis de saída:

              1. Selecione a guia Mapeamentos de variáveis de saída.
              2. Selecione Adicionar mapeamento de variáveis de saída e repita as etapas seguidas para o mapeamento de variáveis de entrada.

6. Clique em Próxima: configuração da versão.

7. Em Nome da versão, digite um nome para a versão.

8. Opcional: adicione um rótulo aos recursos que você está implantando. Para mais detalhes sobre rótulos, consulte a Visão geral de rótulos.

   Para adicionar um marcador:

   1. Em Marcadores, selecione Adicionar marcadores.

   2. Em Chave 1 e Valor 1, insira o par de chave-valor desejado.

   3. Repita as etapas para cada marcador que você quiser adicionar.

9. Clique em Criar.

Você criou um tipo de unidade. Para criar outro tipo de unidade, repita as mesmas etapas e use o arquivo ZIP que contém a configuração do Terraform para esse próximo tipo de unidade.

Se você criou todos os tipos de unidades necessários para a oferta de SaaS, é possível implantar uma instância de unidade.

Criar um tipo de unidade usando um repositório Git

Para criar um tipo de unidade usando uma configuração do Terraform em um repositório Git, siga estas instruções.

Para detalhes sobre como usar um repositório Git para os arquivos do Terraform, consulte Conectar a um repositório Git.

1. No console, acesse SaaS Runtime > Tipos de unidades.

   Acessar "Tipos de unidades"

2. Selecione Criar.

3. Em Criar blueprint, selecione Vincular repositório externo.

4. Em Repositório, selecione o repositório Git que tem a configuração do Terraform:

   1. Se o repositório Git estiver vinculado, selecione-o na lista.

   2. Se o repositório não estiver vinculado, clique em Vincular novo repositório para usar o Developer Connect e vincular o repositório.

      1. Selecione Criar nova conexão.

      2. Em Região, selecione uma região para a conexão do Developer Connect. Recomendamos usar a mesma região do repositório do Artifact Registry.

      3. Opcional: em Chave do KMS, especifique uma chave do KMS para criptografia.

      4. Em Ramificação, especifique a ramificação do Git que tem a configuração do Terraform que você quer associar a esse tipo de unidade.

5. Na página Armazenar blueprint:

   1. Em Selecionar repositório do Artifact Registry, clique em Procurar e selecione o repositório do Artifact Registry que você está usando para a oferta de SaaS.

   2. Em Nome da imagem do artefato, insira um nome para a imagem OCI.

   3. Em Versão do Terraform do Infrastructure Manager, selecione a versão do Terraform a ser usada para implantações. Para conferir uma lista de versões compatíveis do Terraform, consulte Versões compatíveis do Terraform.

   4. Para a conta de serviço do Cloud Build, selecione a conta de serviço que tem as permissões para criar a imagem. Para mais detalhes, consulte Conta de serviço de criação de artefatos.

   5. Clique em Próxima: detalhes do tipo de unidade.

6. Na página Configurar propriedades do tipo de unidade, faça o seguinte:

   1. Em Nome do tipo de unidade, insira um nome para o tipo de unidade. O nome precisa conter apenas letras minúsculas, números ou hifens.

   2. Em Oferta de SaaS, selecione a oferta que você quer associar a esse tipo de unidade.

   3. Para Dependências:

      • Se esta for a primeira ou única unidade que você está criando para a oferta de SaaS, não adicione uma dependência.

      • Se você criou outros tipos de unidades que dependem deste, selecione Adicionar dependência.

        1. Em Tipo de unidade, selecione o tipo de unidade existente que depende do tipo que você está criando.

        2. Em Alias, digite um nome que possa ser usado para mapeamento de variáveis de entrada.

        3. Clique em Concluído.

        4. Se quiser definir o mapeamento de variáveis, siga estas etapas. Para mais detalhes sobre o mapeamento de variáveis, consulte Mapeamento de variáveis.

           1. Selecione Definir mapeamentos de variáveis de entrada e saída.

           2. Para Mapeamentos de variáveis de entrada:

              1. Selecione Adicionar mapeamento de variáveis de entrada.
              2. Em Variável, digite o nome da variável de entrada.
              3. Em Tipo de mapeamento, selecione:
                 • De para mapear do outro tipo de unidade.
                 • Para mapear para o outro tipo de unidade.
              4. Em Dependência, selecione o tipo de unidade existente a que você está mapeando variáveis.
              5. Em Variável de saída, digite o nome da variável de saída.
              6. Selecione Concluído.

           3. Para adicionar outra variável de entrada, selecione Adicionar mapeamento de variáveis de entrada e repita as etapas.

           4. Para adicionar mapeamentos de variáveis de saída:

              1. Selecione a guia Mapeamentos de variáveis de saída.
              2. Selecione Adicionar mapeamento de variáveis de saída e repita as etapas seguidas para o mapeamento de variáveis de entrada.

7. Clique em Próxima: configuração da versão.

8. Em Nome da versão, digite um nome para a versão.

9. Opcional: adicione um rótulo aos recursos que você está implantando. Para mais detalhes sobre rótulos, consulte a Visão geral de rótulos.

   Para adicionar um marcador:

   1. Em Marcadores, selecione Adicionar marcadores.

   2. Em Chave 1 e Valor 1, insira o par de chave-valor desejado.

   3. Repita as etapas para cada marcador que você quiser adicionar.

10. Clique em Criar.

Você criou um tipo de unidade. Para criar outro tipo de unidade, repita as mesmas etapas e use o repositório Git que contém a configuração do Terraform para esse próximo tipo de unidade.

Se você criou todos os tipos de unidades necessários para a oferta de SaaS, é possível implantar uma instância de unidade.

Criar um tipo de unidade usando uma imagem atual

Para criar um tipo de unidade usando um blueprint, que é uma imagem do OCI, siga estas instruções.

Para detalhes sobre como criar uma imagem OCI, consulte:

• Criar e enviar uma imagem manualmente
• Automatizar a criação de projetos

1. No console, acesse SaaS Runtime > Tipos de unidades.

   Acessar "Tipos de unidades"

2. Selecione Criar.

3. Em Criar blueprint, selecione Selecionar uma imagem atual do Artifact Registry.

4. Clique em Próxima: configurar blueprint.

5. Na página Armazenar blueprint:

   1. Em Selecione ou insira um blueprint atual do Artifact Registry:

      1. Clique em Procurar.

      2. Navegue até a imagem que contém a configuração do Terraform.

      3. Clique em Selecionar.

   2. Clique em Próxima: detalhes do tipo de unidade.

6. Na página Configurar propriedades do tipo de unidade, faça o seguinte:

   1. Em Nome do tipo de unidade, insira um nome para o tipo de unidade. O nome precisa conter apenas letras minúsculas, números ou hifens.

   2. Em Oferta de SaaS, selecione a oferta que você quer associar a esse tipo de unidade.

   3. Para Dependências:

      • Se esta for a primeira ou única unidade que você está criando para a oferta de SaaS, não adicione uma dependência.

      • Se você criou outros tipos de unidades que dependem deste, selecione Adicionar dependência.

        1. Em Tipo de unidade, selecione o tipo de unidade existente que depende do tipo que você está criando.

        2. Em Alias, digite um nome que possa ser usado para mapeamento de variáveis de entrada.

        3. Clique em Concluído.

        4. Se quiser definir o mapeamento de variáveis, siga estas etapas. Para mais detalhes sobre o mapeamento de variáveis, consulte Mapeamento de variáveis.

           1. Selecione Definir mapeamentos de variáveis de entrada e saída.

           2. Para Mapeamentos de variáveis de entrada:

              1. Selecione Adicionar mapeamento de variáveis de entrada.
              2. Em Variável, digite o nome da variável de entrada.
              3. Em Tipo de mapeamento, selecione:
                 • De para mapear do outro tipo de unidade.
                 • Para mapear para o outro tipo de unidade.
              4. Em Dependência, selecione o tipo de unidade existente a que você está mapeando variáveis.
              5. Em Variável de saída, digite o nome da variável de saída.
              6. Selecione Concluído.

           3. Para adicionar outra variável de entrada, selecione Adicionar mapeamento de variáveis de entrada e repita as etapas.

           4. Para adicionar mapeamentos de variáveis de saída:

              1. Selecione a guia Mapeamentos de variáveis de saída.
              2. Selecione Adicionar mapeamento de variáveis de saída e repita as etapas seguidas para o mapeamento de variáveis de entrada.

7. Clique em Próxima: configuração da versão.

8. Em Nome da versão, digite um nome para a versão.

9. Opcional: adicione um rótulo aos recursos que você está implantando. Para mais detalhes sobre rótulos, consulte a Visão geral de rótulos.

   Para adicionar um marcador:

   1. Em Marcadores, selecione Adicionar marcadores.

   2. Em Chave 1 e Valor 1, insira o par de chave-valor desejado.

   3. Repita as etapas para cada marcador que você quiser adicionar.

10. Clique em Criar.

Você criou um tipo de unidade. Para criar outro tipo de unidade, repita as mesmas etapas e use a imagem do OCI que contém a configuração do Terraform para esse próximo tipo de unidade.

Se você criou todos os tipos de unidades necessários para a oferta de SaaS, é possível implantar uma instância de unidade.

A seguir

• Depois de modelar a oferta de SaaS, é possível implantar uma instância de unidade.
• Para saber mais sobre o ambiente de execução de SaaS, consulte a visão geral do ambiente de execução de SaaS.
• Para mais detalhes sobre as contas de serviço necessárias ao usar o SaaS Runtime, consulte contas de serviço.