Nesta página, explicamos os requisitos e as opções de configuração de rede do cluster do Dataproc.
Requisitos de conectividade do Dataproc
Seu cluster do Dataproc precisa estar em uma rede VPC que atenda aos requisitos de rota e firewall para acessar com segurança as APIs do Google e outros recursos.
Requisitos do trajeto
O agente do Dataproc em execução nas VMs do cluster precisa de uma rota para a Internet para acessar a API de controle do Dataproc e receber os jobs e informar o status. Quando criadas, as redes VPC contêm uma rota padrão gerada pelo sistema para a Internet. Não é recomendável excluir a rota padrão para a Internet. Em vez disso, use firewalls para controlar o acesso à rede. Os clusters somente de IP interno também exigem essa rota padrão para a Internet para acessar as APIs de controle do Dataproc e outros serviços do Google, como o Cloud Storage, mas o tráfego deles não sai dos data centers do Google.
Requisitos de firewall
As máquinas virtuais (VMs) do cluster do Dataproc precisam se comunicar entre si usando os protocolos ICMP, TCP (todas as portas) e UDP (todas as portas).
A regra de firewall default-allow-internal
da rede VPC default
atende aos requisitos de conectividade do cluster do Dataproc
e permite a entrada do intervalo de origem 10.128.0.0/9
de
todas as VMs na rede VPC da seguinte maneira:
Regra | Rede | Direção | Prioridade | Intervalo de origem | Protocolos:Portas |
---|---|---|---|---|---|
default-allow-internal |
default |
entrada | 65534 |
10.128.0.0/9 |
tcp:0-65535 ,udp:0-65535 ,icmp |
Se você excluir a regra de firewall
default-allow-internal
, o tráfego de entrada na rededefault
será bloqueado pela regra implícita de negação de entrada.Se você excluir a regra de firewall
default-allow-internal
ou não usar a rede VPCdefault
, crie sua própria regra que atenda aos requisitos de conectividade do Dataproc e aplique-a à rede VPC do cluster.
Prática recomendada: crie uma regra de firewall de entrada para a rede VPC do cluster que permita conectividade de entrada apenas entre VMs do cluster usando um intervalo de IP de origem ou identificando VMs do cluster por tag de rede ou conta de serviço.
Crie uma regra de firewall de entrada
Se você ou seu administrador de rede ou de segurança criarem uma regra de firewall de entrada para ser aplicada a uma rede VPC de cluster do Dataproc, ela precisará ter as seguintes características:
O parâmetro sources especifica as origens dos pacotes. Todas as VMs de cluster do Dataproc precisam ser capazes de se comunicar entre si. É possível identificar as VMs no cluster por intervalo de endereços IP, tags de origem ou contas de serviço associadas a elas.
O destino da regra precisa identificar as VMs do cluster. O destino pode ser todas as VMs na rede VPC, ou você pode identificar VMs por intervalo de endereços IP, tag de destino ou conta de serviço de destino.
A regra precisa incluir os seguintes protocolos e portas:
- TCP (todas as portas, 0 a 65535)
- UDP (todas as portas, 0 a 65535)
- ICMP
O Dataproc usa serviços que são executados em várias portas. Especificar todas as portas ajuda na execução dos serviços.
Diagnosticar regras de firewall de VPC
Para auditar pacotes não processados por regras de firewall de prioridade mais alta, é possível criar duas regras de firewall de negação de baixa prioridade (65534). Ao contrário das regras de firewall implícitas, é possível ativar a geração de registros de regras de firewall em cada uma destas regras de baixa prioridade:
Uma regra de negação de entrada (fontes
0.0.0.0/0
, todos os protocolos, todos os destinos na rede VPC)Uma regra de negação de saída (destinos
0.0.0.0/0
, todos os protocolos, todos os destinos na rede VPC)
Com essas regras de baixa prioridade e a geração de registros de regras de firewall, é possível registrar pacotes não processados por regras de firewall de prioridade mais alta e possivelmente mais específicas. Essas duas regras de baixa prioridade também se alinham às práticas recomendadas de segurança ao implementar uma estratégia de "pacotes finais eliminados".
Examine os registros das regras de firewall para determinar se você precisa criar ou alterar regras de prioridade mais alta para permitir pacotes. Por exemplo, se os pacotes enviados entre VMs do cluster do Dataproc forem descartados, isso pode ser um sinal de que suas regras de firewall precisam ser ajustadas.
Criar uma rede VPC
Em vez de usar a rede VPC default
, é possível criar sua própria rede VPC de modo automático ou personalizada. Ao criar o cluster, você associa a rede a ele.
Ambiente do Assured Workloads:quando você usa um ambiente do Assured Workloads para conformidade regulatória, o cluster, a rede VPC e os buckets do Cloud Storage precisam estar no ambiente do Assured Workloads.
Como criar um cluster que use a rede VPC
Google Cloud CLI
Use gcloud dataproc clusters create
com a sinalização ‑‑network
ou ‑‑subnet
para criar um cluster em uma sub-rede na sua rede.
Se você usar a sinalização ‐‐network, o cluster usará uma sub-rede com o mesmo nome da rede especificada na região em que o cluster é criado.
--network example
. Como as redes automáticas são criadas com sub-redes em cada região, e cada sub-rede recebe o nome de rede, é possível transmitir o nome da rede VPC de modo automático para a sinalização ‑‑network
.
O cluster usará a sub-rede VPC de modo automático na região especificada com a sinalização ‐‐region.
gcloud dataproc clusters create CLUSTER_NAME \ --network NETWORK_NAME \ --region=REGION \ ... other args ...
--subnet example
. É possível usar a sinalização ‑‑subnet
para criar um cluster que use uma sub-rede de rede VPC personalizada ou de modo automático na região do cluster. Especifique o caminho completo do recurso da sub-rede.
gcloud dataproc clusters create CLUSTER_NAMEW \ --subnet projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \ --region=REGION \ ... other args ...
API REST
É possível especificar o campo GceClusterConfig
networkUri ou subnetworkUri como parte de uma solicitação clusters.create.
Exemplo
POST /v1/projects/my-project-id/regions/us-central1/clusters/ { "projectId": "PROJECT_ID", "clusterName": CLUSTER_NAME, "config": { "configBucket": "", "gceClusterConfig": { "subnetworkUri": SUBNET_NAME, }, ...
Console
Selecione sua rede na seção "Configuração de rede" do painel Personalizar cluster. Depois de escolher a rede, o seletor de Sub-rede exibe as sub-redes disponíveis na região selecionada para o cluster.
Como criar um cluster que use uma rede VPC em outro projeto
Um cluster do Dataproc pode usar uma rede VPC compartilhada definida em um projeto host. O projeto em que o cluster do Dataproc é criado é conhecido como projeto de serviço.
Encontre o número do projeto do cluster do Dataproc:
- Abra a página Configurações de IAM e administrador no console do Google Cloud. Selecione o projeto em que você criará o cluster do Dataproc. Copie o ID do projeto.
Um principal com o papel de administrador de VPC compartilhada precisa executar as etapas a seguir. Consulte as instruções para configurar a VPC compartilhada para ver informações básicas.
Verifique se o projeto host da VPC compartilhada está ativado.
Anexe o projeto com o cluster do Dataproc ao projeto host.
Siga as instruções nesta subetapa para configurar ambas as contas de serviço a seguir para que tenham o papel de usuário de rede no projeto host:
- Conta de serviço do agente de serviço do Dataproc:
service-[project-number]@dataproc-accounts.iam.gserviceaccount.com
- Conta de serviço das APIs do Google:
[project-number]@cloudservices.gserviceaccount.com
Abra a página IAM e administrador no console do Google Cloud.
Use o seletor de projetos para escolher o novo projeto host.
Clique em Permitir acesso.
Preencha o formulário para conceder acesso. Repita essas etapas para adicionar as duas contas de serviço:
Adicionar principais: informe a conta de serviço.
Atribuir papéis: insira "Rede do Compute" na caixa do filtro e selecione o papel Usuário da rede do Compute.
Clique em Salvar.
- Conta de serviço do agente de serviço do Dataproc:
Depois que ambas as contas de serviço tiverem o papel
Network User
para o projeto host, crie um cluster que use a rede VPC compartilhada.
Criar um cluster que use uma sub-rede VPC em outro projeto
Um cluster do Dataproc pode usar uma sub-rede VPC compartilhada definida em um projeto host. O projeto em que o cluster do Dataproc é criado é conhecido como projeto de serviço.
Encontre o número do projeto do cluster do Dataproc:
- Abra a página Configurações de IAM e administrador no console do Google Cloud. Selecione o projeto em que você criará o cluster do Dataproc. Copie o ID do projeto.
Um principal com o papel de administrador de VPC compartilhada precisa executar as etapas a seguir. Consulte as instruções para configurar a VPC compartilhada para ver informações básicas.
Verifique se o projeto host da VPC compartilhada está ativado.
Anexe o projeto com o cluster do Dataproc ao projeto host.
Siga as instruções nesta etapa para configurar ambas as contas de serviço a seguir para que tenham o papel de Usuário de rede no projeto host:
- Conta de serviço do agente de serviço do Dataproc:
service-[project-number]@dataproc-accounts.iam.gserviceaccount.com
- Conta de serviço das APIs do Google:
[project-number]@cloudservices.gserviceaccount.com
Abra a página Redes VPC no console do Google Cloud.
Use o seletor de projetos para escolher o projeto host.
Clique na rede que contém a sub-rede que o cluster do Dataproc usará.
Na página Detalhes da rede VPC, clique na caixa de seleção ao lado do nome da sub-rede que o cluster usará.
Se o painel de informações não estiver aberto, clique em Mostrar painel de informações.
Siga estas etapas para cada conta de serviço:
No painel de informações, clique em Adicionar principal.
Preencha o formulário Permitir acesso:
Adicionar principais: informe a conta de serviço.
Atribuir papéis: insira "Rede do Compute" na caixa do filtro e selecione o papel Usuário da rede do Compute.
Clique em Salvar.
- Conta de serviço do agente de serviço do Dataproc:
Depois que ambas as contas de serviço tiverem o papel
Network User
para o projeto host, crie um cluster que use a sub-rede VPC compartilhada.
Criar um cluster do Dataproc somente com endereços IP internos
É possível criar um cluster do Dataproc isolado da Internet pública com instâncias de VM que se comunicam por uma sub-rede IP particular. As VMs do cluster não recebem endereços IP públicos. Para isso, a sub-rede precisa ter o Acesso privado do Google ativado para permitir que os nós do cluster acessem APIs e serviços do Google, como o Cloud Storage, por IPs internos.
CLI da gcloud
Só é possível criar um cluster do Dataproc com endereços IP internos usando o comando gcloud dataproc clusters create
com a sinalização ‑‑no-address
.
Use as sinalizações ‐‐no-address e ‐‐network:
use a sinalização ‑‑no-address
com a
sinalização ‑‑network
para criar um cluster que usará
uma sub-rede com o mesmo nome da rede na região
em que o cluster foi criado.
gcloud dataproc clusters create CLUSTER_NAME \ --no-address \ --network NETWORK_NAME \ --region=REGION \ ... other args ...
Por exemplo, como as redes automáticas são criadas com sub-redes em cada região com o mesmo nome da rede automática, é possível passar o nome dessa rede para a ‑‑network flag
para criar um cluster que use a sub-rede automática na região do cluster.
Use as sinalizações ‐‐no-address e ‐‐subnet: use a sinalização ‑‑no-address
com as sinalizações ‑‑subnet
para criar um cluster que usará uma sub-rede automática ou personalizada na região em que o cluster será criado. Transmita a sinalização ‑‑subnet
o caminho completo do recurso da sub-rede.
gcloud dataproc clusters create cluster-name \ --no-address \ --subnet projects/project-id/regions/region/subnetworks/subnetwork-name \ --region=region \ ... other args ...
API REST
É possível definir o campo GceClusterConfig
internalIpOnly
como true
como parte de uma solicitação
clusters.create
para ativar apenas endereços IP internos.
Exemplo:
POST /v1/projects/my-project-id/regions/us-central1/clusters/ { "projectId": "my-project-id", "clusterName": "example-cluster", "config": { "configBucket": "", "gceClusterConfig": { "subnetworkUri": "custom-subnet-1", "zoneUri": "us-central1-b", "internalIpOnly": true }, ...
Console
É possível criar um cluster do Dataproc com Acesso privado do Google ativado na página Criar um cluster do Dataproc no console do Google Cloud. Clique em Somente IP interno no painel Personalizar cluster para ativar esse recurso no cluster.
Como, por padrão, os clusters somente de IP interno não têm acesso à Internet, os jobs que fazem o download de dependências da Internet, como aqueles que fazem o download de pacotes de dependência do Spark do Maven Central, falharão. Há várias soluções para evitar o problema:
Use o Cloud NAT para ativar o acesso do cluster à Internet.
Crie uma imagem personalizada que inclua as dependências (por exemplo, pacotes de dependência do Spark em
/usr/lib/spark/jars/
).Faça upload das dependências para um bucket do Cloud Storage e use uma ação de inicialização para fazer o download das dependências do bucket durante a criação do cluster.
Redes Dataproc e VPC Service Controls
Com o VPC Service Controls, os administradores podem definir um perímetro de segurança em torno dos recursos dos serviços gerenciados pelo Google para controlar a comunicação entre esses serviços.
Observe as seguintes limitações e estratégias ao usar redes VPC Service Controls com clusters do Dataproc:
Para instalar componentes fora do perímetro do VPC Service Controls, crie uma imagem personalizada do Dataproc que pré-instale os componentes e crie o cluster usando a imagem personalizada.
Consulte Etapas especiais do Dataproc para proteção usando o VPC Service Controls.