Criar uma instância particular com peering de VPC

Nesta página, descrevemos como criar uma instância do Cloud Data Fusion com um endereço IP interno. Você cria a instância em uma rede VPC ou VPC compartilhada.

Observação: no Cloud Data Fusion 6.10.0 e versões mais recentes, recomendamos criar instâncias privadas com o Private Service Connect, e não com o peering de rede VPC.

Uma instância particular do Cloud Data Fusion tem os seguintes benefícios:

• As conexões com a instância são estabelecidas em uma rede VPC particular no projeto do Google Cloud . O tráfego na rede não passa pela Internet pública.

• A instância pode se conectar aos recursos locais, como bancos de dados relacionais, porque sua rede local se conecta à rede VPC particularGoogle Cloud por meio do Cloud VPN ou do Cloud Interconnect. Você pode acessar com segurança seus recursos locais, como bancos de dados, pela rede particular sem abrir o acesso ao Google Cloud.

Objetivos

• Configure a rede VPC ou a rede VPC compartilhada.
• Alocar um intervalo de IP que será usado para implantar a instância do Cloud Data Fusion no projeto de locatário.
• Crie a instância particular do Cloud Data Fusion.
• Configure o peering de rede VPC entre a VPC que contém a instância do Cloud Data Fusion e a VPC que contém o projeto de locatário associado.
• Para redes VPC compartilhadas, configure permissões do Identity and Access Management (IAM).
• Se a instância particular usa o Cloud Data Fusion versão 6.2.0 ou anterior, crie uma regra de firewall.
• Permita que diferentes serviços Google Cloud se comuniquem internamente entre si ativando o Acesso privado do Google na sub-rede do Managed Service for Apache Spark.

Antes de começar

• Para saber mais sobre a arquitetura de implantação do Cloud Data Fusion, consulte Rede.

Configurar a rede VPC

Se você ainda não tiver feito isso, crie uma rede VPC ou uma rede VPC compartilhada.

Para configurar sua rede VPC, aloque um intervalo de endereços IP.

Aloque um intervalo de IP

Rede VPC

Se você não estiver usando uma rede VPC compartilhada, o Cloud Data Fusion alocará um intervalo de IP por padrão ao criar uma instância.

Observação: se você não estiver usando uma rede VPC compartilhada, pule esta seção e acesse Criar uma instância particular.

Rede VPC compartilhada

Observação: siga estas etapas somente se estiver usando uma rede VPC compartilhada.

Para usar uma VPC compartilhada, aloque um intervalo de IP para sua instância do Cloud Data Fusion.

Para alocar um intervalo de IP à sua instância do Cloud Data Fusion, siga estas etapas:

1. No console do Google Cloud , acesse a página Redes VPC.

   Acessar redes VPC

2. Na coluna Nome, clique na rede VPC em que você quer criar uma instância particular do Cloud Data Fusion.

   A página Detalhes da rede VPC é aberta.

3. Clique em Conexão de serviço privado. Se solicitado, ative a API Service Networking clicando em Ativar API.

   

4. Clique em Alocar intervalo de IP.

   1. Dê um nome ao intervalo de IP.

   2. Em Intervalo de IP, clique em Automático.

      Observação: para intervalos personalizados, o Cloud Data Fusion é compatível com intervalos de endereços IPv4 particulares válidos, incluindo intervalos de IP não RFC 1918. Não há suporte para intervalos de endereços IP externo usados de modo particular. Essa alocação de intervalo não precisa consumir IPs de nenhuma das suas sub-redes, mas não pode se sobrepor a nenhuma alocação de intervalo que você fizer no futuro.

   3. Especifique um tamanho de prefixo 22.

      Observação: o intervalo de IP /22 é obrigatório por instância do Cloud Data Fusion e não pode ser compartilhado por várias instâncias. O intervalo de IP pertence a Google Cloud e é onde os componentes e a infraestrutura da instância subjacente são hospedados.

   4. Clique em Alocar.

      

Criar uma instância particular

Crie a instância particular do Cloud Data Fusion em uma rede VPC ou VPC compartilhada.

Atenção: depois de criar uma instância do Cloud Data Fusion, não é possível mudar a edição dela.

Rede VPC

Para criar a instância em uma rede VPC, use o consoleGoogle Cloud ou o cURL.

Se você usar o console Google Cloud para criar sua instância particular, o Cloud Data Fusion vai alocar o intervalo de endereços IP /22 por padrão. Para escolher um intervalo de IP diferente, use o comando cURL.

Console

1. Acesse a página Criar instância do Data Fusion.

   Acesse "Criar instância do Data Fusion"

2. Digite um nome e uma descrição para a instância.

3. Selecione a Região em que a instância será criada.

4. Selecione uma versão e uma edição do Cloud Data Fusion.

5. Especifique a conta de serviço do Managed Service for Apache Spark a ser usada para executar o pipeline do Cloud Data Fusion no Managed Service for Apache Spark. A conta padrão do Compute Engine é pré-selecionada.

   Observação: conceda à conta de serviço os papéis adequados do Identity and Access Management para suas necessidades. Para mais informações, consulte Como conceder permissão ao usuário da conta de serviço.

6. Abra o menu Opções avançadas e clique em Ativar IP particular.

7. No campo Rede, escolha uma rede em que criar a instância.

8. Clique em Criar. O processo de criação da instância leva até 30 minutos para ser concluído.

   Observação: enquanto o Cloud Data Fusion cria a instância, um indicador de progresso é exibido ao lado do nome dela na página Instâncias. Após a conclusão, o indicador se transforma em uma marca de seleção verde, indicando que a instância já pode ser usada.

cURL

Para sua conveniência, é possível exportar as seguintes variáveis ou substituir esses valores diretamente nos comandos abaixo:

export PROJECT=PROJECT_ID
export LOCATION=REGION
export DATA_FUSION_API_NAME=datafusion.googleapis.com

Para criar a instância, chame o método create() dela:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://$DATA_FUSION_API_NAME/v1/projects/$PROJECT/locations/$LOCATION/instances?instance_id=INSTANCE_ID -X POST -d '{"description": "Private CDF instance created through REST.", "type": "ENTERPRISE", "privateInstance": true, "networkConfig": {"network": "NETWORK_NAME", "ipAllocation": "IP_RANGE"}}'

Substitua:

• INSTANCE_ID: a string de ID que sua nova instância vai receber.
• NETWORK_NAME: o nome da rede VPC em que você quer criar a instância particular.
• IP_RANGE: o intervalo de IP alocado. Para encontrar o intervalo de IP no consoleGoogle Cloud , acesse Detalhes da rede VPC > Conexão de serviço particular > Intervalo de IP interno .

Rede VPC compartilhada

Para criar sua instância em uma rede VPC compartilhada, use o cURL, não o consoleGoogle Cloud .

cURL

Para sua conveniência, é possível exportar as seguintes variáveis. Como alternativa, substitua esses valores diretamente nos seguintes comandos:

export PROJECT=PROJECT_ID
export LOCATION=REGION
export DATA_FUSION_API_NAME=datafusion.googleapis.com

Para criar a instância, chame o método create() dela:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://$DATA_FUSION_API_NAME/v1/projects/$PROJECT/locations/$LOCATION/instances?instanceId=INSTANCE_ID -X POST -d '{"description": "Private CDF instance created through REST.", "type": "ENTERPRISE", "privateInstance": true, "networkConfig": {"network": "projects/SHARED_VPC_HOST_PROJECT_ID/global/networks/NETWORK_NAME", "ipAllocation": "IP_RANGE"}}'

Substitua:

• INSTANCE_ID: a string de ID que sua nova instância vai receber.
• SHARED_VPC_HOST_PROJECT_ID: o ID do projeto que hospeda a rede VPC compartilhada.
• NETWORK_NAME: o nome da rede VPC em que você quer criar a instância privada.
• IP_RANGE: o intervalo de IP alocado. Para encontrar o intervalo de IP no console Google Cloud , acesse a página Detalhes da rede VPC > Conexão de serviço particular > Intervalo de IP interno.

Observação: não é possível usar um intervalo de IP alocado para outro serviço Google Cloud. Ele precisa ser o mesmo intervalo de IP alocado na etapa anterior.

Observação: ao usar uma rede VPC compartilhada, o nome do peering de rede VPC criado entre seu projeto e o projeto de locatário é uma combinação do nome da rede VPC e do nome da instância. O comprimento do nome do peering de rede VPC não pode exceder 63 caracteres.

Configurar o peering de rede VPC

Ponto-chave: sua instância do Cloud Data Fusion é criada em uma VPC própria, e talvez seja necessário configurar o peering de rede VPC para se conectar à origem e ao destino usados no pipeline.

Os serviços do Cloud Data Fusion que você usa no seu ambiente de design (por exemplo, Wrangler, Connection Manager e Schema Validation) iniciam conexões de rede da VPC do projeto de locatário com os sistemas de origem. O Cloud Data Fusion usa o peering de rede VPC para estabelecer a conectividade de rede com a VPC ou a VPC compartilhada que contém sua instância. O peering de rede VPC permite que o Cloud Data Fusion acesse recursos na sua rede por endereços IP internos usando sua própria VPC e os controles dela. Para se conectar a um recurso em outra rede, consulte as etapas para casos de uso de conexão.

A seção a seguir descreve como criar uma configuração de peering entre sua rede e a rede do projeto de locatário do Cloud Data Fusion.

Receber o ID do projeto de locatário

Para criar uma configuração de peering, você precisa do ID do projeto de locatário.

1. Acesse a página Instâncias do Cloud Data Fusion.

   Acesse "Instâncias"

2. Na coluna Nome da instância, selecione a instância.

3. Na página Detalhes da instância, copie o ID do projeto do locatário, que é necessário ao criar uma conexão de peering nas etapas a seguir.

Criar uma conexão de peering

1. Acesse a página Peering de rede VPC.

   Acessar o peering de rede VPC

2. Clique em Criar conexão > Continuar.

3. Na página Criar conexão de peering, faça o seguinte:

   1. Digite um Nome para a conexão de peering.
   2. Em Sua rede VPC, selecione a rede que contém sua instância do Cloud Data Fusion.
   3. Em Rede VPC com peering, selecione Em outro projeto.
   4. Em ID do projeto, digite o ID do projeto de locatário que você encontrou anteriormente neste tutorial.

   5. Em Nome da rede VPC, selecione uma rede ou digite INSTANCE_REGION-INSTANCE_ID.

      Substitua:

      • INSTANCE_REGION: a região em que você criou a instância do Cloud Data Fusion.
      • INSTANCE_ID: o ID da sua instância do Cloud Data Fusion.
      Observação: quando a instância é criada, uma rede VPC chamada INSTANCE_REGION-INSTANCE_ID é criada no projeto do locatário. A instância privada do Cloud Data Fusion é implantada nessa VPC. Essa rede já existe com a configuração para fazer peering com a VPC do projeto do cliente.

   6. Selecione a versão do protocolo da Internet para que a conexão de peering troque rotas IPv4 e IPv6 entre sua rede VPC e a rede VPC com peering. Para mais informações, consulte Peering de rede VPC.

   7. Selecione Exportar rotas personalizadas para que as rotas personalizadas possam ser exportadas da sua rede VPC para a rede VPC do locatário.

   8. Escolha se as rotas de sub-rede com IPv4 público podem ser importadas ou exportadas para sua rede VPC.

   9. Clique em Criar.

   O peering de rede VPC fica ativo logo após a criação.

Configurar permissões do IAM

Rede VPC

Pule esta etapa e acesse Criar uma regra de firewall.

Rede VPC compartilhada

Se você criar sua instância do Cloud Data Fusion em uma rede VPC compartilhada, conceda o papel de usuário da rede do Compute às seguintes contas de serviço. Para conceder permissões a todas as sub-redes, atribua a função ao projeto host da VPC compartilhada.

Para controlar ainda mais o acesso, conceda o papel a uma sub-rede específica e o papel Leitor de rede no projeto host.

• Conta de serviço do Cloud Data Fusion: [e-mail]
• Conta de serviço do Managed Service for Apache Spark: [e-mail]

PROJECT_NUMBER é o número do projetoGoogle Cloud que contém sua instância do Cloud Data Fusion.

Para mais informações, consulte Conceder acesso às contas de serviço necessárias.

Criar uma regra de firewall

Crie uma regra de firewall na rede VPC que permita conexões SSH de entrada do intervalo de IP especificado quando você criou a instância particular do Cloud Data Fusion.

Esta etapa é obrigatória para versões do Cloud Data Fusion anteriores à 6.2.0. Ele permite a comunicação entre o Cloud Data Fusion e os clusters do Managed Service for Apache Spark que executam pipelines.

É possível criar a regra de firewall usando o console do Google Cloud ou a CLI gcloud.

Console

Consulte Como criar regras de firewall.

gcloud

Execute este comando:

gcloud compute firewall-rules create FIREWALL_NAME-allow-ssh --allow=tcp:22 --source-ranges=IP_RANGE --network=NETWORK_NAME --project=PROJECT_ID

Substitua:

• FIREWALL_NAME: o nome da regra de firewall a ser criada.
• IP_RANGE: o intervalo de IP que você alocou.
• NETWORK_NAME: o nome da rede a que a regra de firewall está anexada. É o nome da rede VPC em que você criou a instância particular.
• PROJECT_ID: o ID do projeto que está hospedando a rede VPC.

Etapas para casos de uso de conexão

As seções a seguir descrevem casos de uso relacionados à conexão para instâncias particulares.

Ativar o Acesso privado do Google

Para acessar recursos usando endereços IP internos, o Cloud Data Fusion precisa criar os clusters do Managed Service para Apache Spark e executar os pipelines de dados em uma sub-rede com o Acesso privado do Google. É necessário ativar o Acesso privado do Google para a sub-rede que contém os clusters do Managed Service para Apache Spark.

• Se houver apenas uma sub-rede na região em que os clusters do Managed Service para Apache Spark são iniciados, o cluster será iniciado nessa sub-rede.

• Se houver várias sub-redes em uma região, configure o Cloud Data Fusion para selecionar a sub-rede com o Acesso privado do Google para iniciar clusters do serviço gerenciado para Apache Spark.

  Atenção: se o Acesso privado do Google não estiver ativado nessa sub-rede, a execução do pipeline vai falhar. Para especificar a sub-rede depois de criar uma instância, edite o perfil de computação.

Para ativar o Acesso privado do Google na sub-rede, consulte Configuração do Acesso privado do Google.

Opcional: conectar a outras fontes

Depois de criar uma instância particular no Cloud Data Fusion, você pode se conectar a outras fontes, como os seguintes casos de uso:

• Bancos de dados e sistemas locais em execução em outras redes VPC
• Outros serviços do Google Cloud em execução na própria rede no modo particular, como o Cloud SQL
• Fontes na Internet pública

Opcional: ativar o peering de DNS

Ative o peering de DNS nos seguintes casos:

• Quando o Cloud Data Fusion se conecta a sistemas por nomes de host, e não por endereços IP
• Quando o sistema de destino é implantado atrás de um balanceador de carga, como acontece em algumas implantações do SAP

A seguir

• Saiba mais sobre os conceitos de segurança no Cloud Data Fusion.
• Saiba como se conectar a recursos em redes externas.
• Saiba mais sobre outrosconceitos e recursos importantes do Cloud Data Fusion.
• Consulte os preços do Cloud Data Fusion.