Gerenciar versões personalizadas do conector

Criar uma versão personalizada do conector

Para criar uma versão personalizada do conector, siga estas etapas:

  1. No Console, acesse a página Integration Connectors > Custom connectors, selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conectores personalizados"

    A lista de conectores personalizados vai aparecer.

  2. Clique no conector personalizado para adicionar uma versão.

    Isso mostra a página de detalhes da conexão.

  3. Clique em Versões.

    A página exibe todas as versões do conector.

  4. Clique em Criar. A página Criar nova versão com a nova versão será exibida. número As etapas para criar uma nova versão são semelhantes às da criação de um conector personalizado. Isso significa que você pode criar uma versão com conectividade direta ou indireta.

Gerenciar uma versão personalizada do conector

Para editar um conector personalizado, siga estas etapas:

  1. No Console, acesse a página Integration Connectors > Custom connectors, selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conectores personalizados"

    A lista de conectores personalizados vai aparecer.

  2. Clique no conector personalizado que tem versões.

    A página de detalhes da conexão é exibida.

  3. Clique em Versões.

    As versões do conector selecionado são exibidas.

  4. Clique em Ações para selecionar uma das seguintes opções:
    • Conferir detalhes: para conferir os detalhes da versão do conector personalizado.
    • Suspender o uso da versão: para suspender o uso da versão.
    • Excluir: para excluir a versão.
    • Exportar: para fazer o download da versão do conector como um arquivo de especificação JSON. Para mais informações, consulte Exportar e importar.

Exportar e importar

Você pode compartilhar o conector entre diferentes projetos do Google Cloud exportando e importando a especificação do conector. É possível exportar qualquer versão de conexão e importar a especificação para o mesmo projeto ou para projetos diferentes do Google Cloud. Não é possível exportar versões de conector descontinuadas.

Papéis e permissões necessárias

Para ter as permissões necessárias para exportar e importar um conector personalizado, peça ao administrador para conceder a você os seguintes papéis do IAM:

  • Administrador de objetos do Storage (roles/storage.objectAdmin) no bucket do Cloud Storage
  • Administrador de segurança (roles/iam.securityAdmin) no projeto em que o segredo está presente. Como alternativa, também é possível pedir que o administrador conceda a você ou à conta de serviço as permissões secretmanager.secrets.getIamPolicy e secretmanager.secrets.setIamPolicy no projeto em que o secret está presente.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Exportar um conector personalizado

Para exportar uma versão do conector, siga estas etapas:

  1. No Console, acesse a página Integration Connectors > Custom connectors, selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conectores personalizados"

  2. Clique no conector personalizado que você quer exportar. A página de visão geral do conector personalizado é aberta.
  3. Clique em Versões. Uma lista de versões do conector personalizado será exibida.
  4. Clique em Mais ações e em Exportar. É feito o download de um arquivo de especificação JSON para o conector personalizado.

Importar um conector personalizado

Para importar uma versão do conector, siga estas etapas:

  1. No Console, acesse a página Integration Connectors > Custom connectors, selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conectores personalizados"

    2. A página Conectores personalizados é exibida.
  2. Clique em Importar.
  3. Procure e selecione o arquivo de especificação JSON do conector personalizado. Se você estiver importando o conector para um projeto diferente, o campo Conta de serviço não será preenchido previamente.

    Dependendo da existência ou não do conector, os seguintes cenários são possíveis:

    • O conector com o mesmo nome não existe: a página Criar conector personalizado é exibida. A versão do conector no JSON importado é preenchida automaticamente. Não é possível mudar essa versão.
    • Existe um conector com o mesmo nome, mas a mesma versão não existe: a página Criar versão desse conector é exibida. As propriedades do conector, como tipo, nome e descrição, são preenchidas automaticamente com base no conector atual e não são substituídas pelo JSON importado. No entanto, os detalhes e o nome da versão do conector são lidos no JSON importado. Só é possível editar o nome da versão.
    • Existe um conector com o mesmo nome e versão: uma mensagem de aviso é exibida informando que a versão já existe e uma nova versão será usada quando você importar a especificação JSON. Se você clicar em Importar, a página Criar versão do conector será exibida. As propriedades do conector, como o tipo, o nome e a descrição, são preenchidas automaticamente pelo conector existente e não são substituídas pelo JSON importado. No entanto, os detalhes da versão são lidos do JSON importado e podem ser editados. O número da versão mais recente disponível é usado como nome da versão.
  4. Preencha os outros detalhes e clique em Criar. O conector é criado com a especificação JSON importada.