Ambientes do Google Cloud

O Citrix Virtual Apps and Desktops™ permite provisionar e gerenciar máquinas no Google Cloud.

Requisitos

• Conta do Citrix Cloud™. O recurso descrito neste artigo está disponível apenas no Citrix Cloud.
• Um projeto do Google Cloud. O projeto armazena todos os recursos de computação associados ao catálogo de máquinas. Pode ser um projeto existente ou um novo.
• Habilite quatro APIs em seu projeto do Google Cloud. Para obter detalhes, consulte Habilitar APIs do Google Cloud.
• Conta de serviço do Google Cloud. A conta de serviço autentica-se no Google Cloud para permitir o acesso ao projeto. Para obter detalhes, consulte Configurar e atualizar contas de serviço.
• Habilite o acesso privado do Google. Para obter detalhes, consulte Habilitar acesso privado do Google.

Habilitar APIs do Google Cloud

Para usar a funcionalidade do Google Cloud através do Web Studio, habilite estas APIs em seu projeto do Google Cloud:

• API do Compute Engine
• API do Cloud Resource Manager
• API do Identity and Access Management (IAM)
• API do Cloud Build
• Cloud Key Management Service (KMS)

No console do Google Cloud, conclua estas etapas:

1. No menu superior esquerdo, selecione APIs e Serviços > Painel.

   

2. Na tela Painel, certifique-se de que a API do Compute Engine esteja ativada. Se não estiver, siga estas etapas:

   1. Navegue até APIs e Serviços > Biblioteca.

      

   2. Na caixa de pesquisa, digite Compute Engine.

   3. Nos resultados da pesquisa, selecione API do Compute Engine.

   4. Na página API do Compute Engine, selecione Ativar.

3. Ative a API do Cloud Resource Manager.

   1. Navegue até APIs e Serviços > Biblioteca.

   2. Na caixa de pesquisa, digite Cloud Resource Manager.

   3. Nos resultados da pesquisa, selecione API do Cloud Resource Manager.

   4. Na página API do Cloud Resource Manager, selecione Ativar. O status da API é exibido.

4. Da mesma forma, ative a API do Identity and Access Management (IAM) e a API do Cloud Build.

Você também pode usar o Google Cloud Shell para habilitar as APIs. Para fazer isso:

1. Abra o Google Console e carregue o Cloud Shell.

2. Execute os quatro comandos a seguir no Cloud Shell:

   • gcloud services enable compute.googleapis.com
   • gcloud services enable cloudresourcemanager.googleapis.com
   • gcloud services enable iam.googleapis.com
   • gcloud services enable cloudbuild.googleapis.com
3. Clique em Autorizar se o Cloud Shell solicitar.

Configurar e atualizar contas de serviço

Nota:

O GCP está introduzindo alterações no comportamento padrão e no uso de contas de serviço do Cloud Build Service após 29 de abril de 2024. Para obter mais informações, consulte Alteração da Conta de Serviço do Cloud Build. Seus projetos existentes do Google com a API do Cloud Build habilitada antes de 29 de abril de 2024 não são afetados por essa alteração. No entanto, se você quiser manter o comportamento existente do Cloud Build Service após 29 de abril, poderá criar ou aplicar a política da organização para desabilitar a imposição da restrição antes de habilitar a API do Cloud Build. Como resultado, o conteúdo a seguir é dividido em dois: Antes de 29 de abril de 2024 e Depois de 29 de abril de 2024. Se você definir a nova política da organização, siga a seção Antes de 29 de abril de 2024.

Antes de 29 de abril de 2024

O Citrix Cloud usa três contas de serviço separadas dentro do projeto do Google Cloud:

• Conta de Serviço do Citrix Cloud: Esta conta de serviço permite que o Citrix Cloud acesse o projeto do Google, provisione e gerencie máquinas. Esta conta de serviço se autentica no Google Cloud usando uma chave gerada pelo Google Cloud.

  Você deve criar esta conta de serviço manualmente conforme descrito aqui. Para obter mais informações, consulte Criar uma Conta de Serviço do Citrix Cloud.

  Você pode identificar esta conta de serviço com um endereço de e-mail. Por exemplo, <my-service-account>@<project-id>.iam.gserviceaccount.com.

• Conta de Serviço do Cloud Build: Esta conta de serviço é provisionada automaticamente depois que você habilita todas as APIs mencionadas em Habilitar APIs do Google Cloud. Para visualizar todas as contas de serviço criadas automaticamente, navegue até IAM e Administrador > IAM no console do Google Cloud e selecione a caixa de seleção Incluir concessões de função fornecidas pelo Google.

  Você pode identificar esta conta de serviço por um endereço de e-mail que começa com o ID do Projeto e a palavra cloudbuild. Por exemplo, <project-id>@cloudbuild.gserviceaccount.com

  Verifique se a conta de serviço recebeu as seguintes funções. Se você precisar adicionar funções, siga as etapas descritas em Adicionar funções à Conta de Serviço do Cloud Build.

  • Conta de Serviço do Cloud Build
  • Administrador de Instância de Computação
  • Usuário da Conta de Serviço

• Conta de Serviço do Cloud Compute: Esta conta de serviço é adicionada pelo Google Cloud às instâncias criadas no Google Cloud assim que a API Compute é ativada. Esta conta tem a função de editor básico do IAM para realizar as operações. No entanto, se você excluir a permissão padrão para ter um controle mais granular, deverá adicionar uma função de Administrador de Armazenamento que requer as seguintes permissões:

  • resourcemanager.projects.get
  • storage.objects.create
  • storage.objects.get
  • storage.objects.list

Você pode identificar esta conta de serviço por um endereço de e-mail que começa com o ID do Projeto e a palavra compute. Por exemplo, <project-id>-compute@developer.gserviceaccount.com.

Criar uma Conta de Serviço do Citrix Cloud

Para criar uma Conta de Serviço do Citrix Cloud, siga estas etapas:

1. No console do Google Cloud, navegue até IAM e Administrador > Contas de serviço.
2. Na página Contas de serviço, selecione CRIAR CONTA DE SERVIÇO.
3. Na página Criar conta de serviço, insira as informações necessárias e, em seguida, selecione CRIAR E CONTINUAR.

4. Na página Conceder acesso a este projeto a esta conta de serviço, clique no menu suspenso Selecionar um papel e selecione os papéis necessários. Clique em +ADICIONAR OUTRO PAPEL se quiser adicionar mais papéis.

   Cada conta (pessoal ou de serviço) tem vários papéis que definem o gerenciamento do projeto. Conceda os seguintes papéis a esta conta de serviço:

   • Administrador de Computação
   • Administrador de Armazenamento
   • Editor do Cloud Build
   • Usuário da Conta de Serviço
   • Usuário do Cloud Datastore
   • Operador de Criptografia do Cloud KMS

   O Operador de Criptografia do Cloud KMS requer as seguintes permissões:

   • cloudkms.cryptoKeys.get
   • cloudkms.cryptoKeys.list
   • cloudkms.keyRings.get
   • cloudkms.keyRings.list

   Observação:

   Habilite todas as APIs para obter a lista completa de funções disponíveis ao criar uma nova conta de serviço.

5. Clique em CONTINUAR
6. Na página Grant users access to this service account, adicione usuários ou grupos para conceder-lhes acesso para realizar ações nesta conta de serviço.
7. Clique em CONCLUÍDO.
8. Navegue até o console principal do IAM.
9. Identifique a conta de serviço criada.
10. Valide se as funções foram atribuídas com sucesso.

Considerações:

Ao criar a conta de serviço, considere o seguinte:

• As etapas Grant this service account access to project e Grant users access to this service account são opcionais. Se você optar por pular essas etapas de configuração opcionais, a conta de serviço recém-criada não será exibida na página IAM & Admin > IAM.
• Para exibir as funções associadas a uma conta de serviço, adicione as funções sem pular as etapas opcionais. Esse processo garante que as funções apareçam para a conta de serviço configurada.

Chave da conta de serviço do Citrix Cloud

A chave da conta de serviço do Citrix Cloud é necessária para criar uma conexão no Citrix DaaS. A chave está contida em um arquivo de credenciais (.json). O arquivo é baixado e salvo automaticamente na pasta Downloads após a criação da chave. Ao criar a chave, certifique-se de definir o tipo de chave como JSON. Caso contrário, o Web Studio não poderá analisá-la.

Para criar uma Chave de Conta de Serviço, navegue até IAM e Administrador > Contas de serviço e clique no endereço de e-mail da Conta de Serviço do Citrix Cloud. Mude para a guia Chaves e selecione Adicionar Chave > Criar nova chave. Certifique-se de selecionar JSON como o tipo de chave.

Dica:

Crie chaves usando a página Contas de serviço no console do Google Cloud. Recomendamos que você altere as chaves regularmente por motivos de segurança. Você pode fornecer novas chaves para o aplicativo Citrix Virtual Apps and Desktops editando uma conexão existente do Google Cloud.

Adicionar funções à Conta de Serviço do Citrix Cloud

Para adicionar funções à Conta de Serviço do Citrix Cloud:

1. No console do Google Cloud, navegue até IAM e Administrador > IAM.

2. Na página IAM > PERMISSÕES, localize a conta de serviço que você criou, identificável por um endereço de e-mail.

   Por exemplo, <my-service-account>@<project-id>.iam.gserviceaccount.com

3. Selecione o ícone de lápis para editar o acesso ao principal da conta de serviço.
4. Na página Editar acesso a “project-id” para a opção principal selecionada, selecione ADICIONAR OUTRA FUNÇÃO para adicionar as funções necessárias à sua conta de serviço uma por uma e, em seguida, selecione SALVAR.

Adicionar funções à Conta de Serviço do Cloud Build

Para adicionar funções à Conta de Serviço do Cloud Build:

1. No console do Google Cloud, navegue até IAM e Administrador > IAM.

2. Na página IAM, localize a conta de serviço do Cloud Build, identificável por um endereço de e-mail que começa com o ID do Projeto e a palavra cloudbuild.

   Por exemplo, <project-id>@cloudbuild.gserviceaccount.com

3. Selecione o ícone de lápis para editar as funções da conta do Cloud Build.

4. Na página Editar acesso a “project-id” para a opção principal selecionada, selecione ADICIONAR OUTRA FUNÇÃO para adicionar as funções necessárias à sua conta de serviço do Cloud Build uma a uma e, em seguida, selecione SALVAR.

   Nota:

   Habilite todas as APIs para obter a lista completa de funções.

Após 29 de abril de 2024

O Citrix Cloud usa duas contas de serviço separadas dentro do projeto do Google Cloud:

• Conta de Serviço do Citrix Cloud: Esta conta de serviço permite que o Citrix Cloud acesse o projeto do Google, provisione e gerencie máquinas. Esta conta de serviço autentica-se no Google Cloud usando uma chave gerada pelo Google Cloud.

  Você deve criar esta conta de serviço manualmente.

  Você pode identificar esta conta de serviço por um endereço de e-mail. Por exemplo, <my-service-account>@<project-id>.iam.gserviceaccount.com.

• Conta de Serviço do Cloud Compute: Esta conta de serviço é provisionada automaticamente depois que você habilita todas as APIs mencionadas em Habilitar APIs do Google Cloud. Para visualizar todas as contas de serviço criadas automaticamente, navegue até IAM e Admin > IAM no console do Google Cloud e selecione a caixa de seleção Incluir concessões de função fornecidas pelo Google. Esta conta tem a função de editor básico do IAM para realizar as operações. No entanto, se você excluir a permissão padrão para ter um controle mais granular, deverá adicionar a função de Administrador de Armazenamento que requer as seguintes permissões:

  • resourcemanager.projects.get
  • storage.objects.create
  • storage.objects.get
  • storage.objects.list

  Você pode identificar esta conta de serviço por um endereço de e-mail que começa com o ID do Projeto e a palavra compute. Por exemplo, <project-id>-compute@developer.gserviceaccount.com.

  Verifique se a conta de serviço recebeu as seguintes funções.

  • Conta de Serviço do Cloud Build
  • Administrador de Instância de Computação
  • Usuário da Conta de Serviço

Criar uma Conta de Serviço do Citrix Cloud

Para criar uma Conta de Serviço do Citrix Cloud, siga estas etapas:

1. No console do Google Cloud, navegue até IAM e Administrador > Contas de serviço.
2. Na página Contas de serviço, selecione CRIAR CONTA DE SERVIÇO.
3. Na página Criar conta de serviço, insira as informações necessárias e, em seguida, selecione CRIAR E CONTINUAR.

4. Na página Conceder acesso desta conta de serviço ao projeto, clique no menu suspenso Selecionar uma função e selecione as funções necessárias. Clique em +ADICIONAR OUTRA FUNÇÃO se quiser adicionar mais funções.

   Cada conta (pessoal ou de serviço) tem várias funções que definem o gerenciamento do projeto. Conceda as seguintes funções a esta conta de serviço:

   • Administrador de Computação
   • Administrador de Armazenamento
   • Editor do Cloud Build
   • Usuário da Conta de Serviço
   • Usuário do Cloud Datastore
   • Operador de Criptografia do Cloud KMS

   O Operador de Criptografia do Cloud KMS requer as seguintes permissões:

   • cloudkms.cryptoKeys.get
   • cloudkms.cryptoKeys.list
   • cloudkms.keyRings.get
   • cloudkms.keyRings.list

   Nota:

   Habilite todas as APIs para obter a lista completa de funções disponíveis ao criar uma nova conta de serviço.

5. Clique em CONTINUAR
6. Na página Conceder acesso de usuários a esta conta de serviço, adicione usuários ou grupos para conceder-lhes acesso para realizar ações nesta conta de serviço.
7. Clique em CONCLUÍDO.
8. Navegue até o console principal do IAM.
9. Identifique a conta de serviço criada.
10. Valide se as funções foram atribuídas com sucesso.

Considerações:

Ao criar a conta de serviço, considere o seguinte:

• As etapas Conceder a esta conta de serviço acesso ao projeto e Conceder acesso de usuários a esta conta de serviço são opcionais. Se você optar por pular essas etapas de configuração opcionais, a conta de serviço recém-criada não será exibida na página IAM e Administrador > IAM.
• Para exibir as funções associadas a uma conta de serviço, adicione as funções sem pular as etapas opcionais. Esse processo garante que as funções apareçam para a conta de serviço configurada.

Chave da conta de serviço do Citrix Cloud

A chave da conta de serviço do Citrix Cloud é necessária para criar uma conexão no Citrix DaaS. A chave está contida em um arquivo de credenciais (.json). O arquivo é baixado automaticamente e salvo na pasta Downloads depois que você cria a chave. Ao criar a chave, certifique-se de definir o tipo de chave como JSON. Caso contrário, o Web Studio não poderá analisá-la.

Para criar uma Chave de Conta de Serviço, navegue até IAM e Administrador > Contas de serviço e clique no endereço de e-mail da Conta de Serviço do Citrix Cloud. Mude para a guia Chaves e selecione Adicionar chave > Criar nova chave. Certifique-se de selecionar JSON como o tipo de chave.

Dica:

Crie chaves usando a página Contas de serviço no console do Google Cloud. Recomendamos que você altere as chaves regularmente por motivos de segurança. Você pode fornecer novas chaves para o aplicativo Citrix Virtual Apps and Desktops editando uma conexão existente do Google Cloud.

Adicionar funções à conta de serviço do Citrix Cloud

Para adicionar funções à conta de serviço do Citrix Cloud:

1. No console do Google Cloud, navegue até IAM e Administrador > IAM.

2. Na página IAM > PERMISSÕES, localize a conta de serviço que você criou, identificável por um endereço de e-mail.

   Por exemplo, <my-service-account>@<project-id>.iam.gserviceaccount.com

3. Selecione o ícone de lápis para editar o acesso ao principal da conta de serviço.
4. Na página Editar acesso a “project-id” para a opção de principal selecionada, selecione ADICIONAR OUTRO PAPEL para adicionar os papéis necessários à sua conta de serviço um por um e, em seguida, selecione SALVAR.

Adicionar papéis à conta de serviço do Cloud Compute

Para adicionar papéis à conta de serviço do Cloud Compute:

1. No console do Google Cloud, navegue até IAM e Administrador > IAM.

2. Na página IAM, localize a conta de serviço do Cloud Compute, identificável por um endereço de e-mail que começa com o ID do Projeto e a palavra compute.

   Por exemplo, <project-id>-compute@developer.gserviceaccount.com

3. Selecione o ícone de lápis para editar os papéis da conta do Cloud Build.

4. Na página Editar acesso a “project-id” para a opção de principal selecionada, selecione ADICIONAR OUTRO PAPEL para adicionar os papéis necessários à sua conta de serviço do Cloud Build um por um e, em seguida, selecione SALVAR.

   Nota:

   Habilite todas as APIs para obter a lista completa de papéis.

Permissões de armazenamento e gerenciamento de bucket

O Citrix Virtual Apps and Desktops melhora o processo de relatório de falhas de compilação na nuvem para o serviço Google Cloud. Este serviço executa compilações no Google Cloud. O Citrix Virtual Apps and Desktops cria um bucket de armazenamento chamado citrix-mcs-cloud-build-logs-{region}-{5 random characters} onde os serviços do Google Cloud capturam informações de log de compilação. Uma opção é definida neste bucket que exclui o conteúdo após um período de 30 dias. Este processo exige que a conta de serviço usada para a conexão tenha as permissões do Google Cloud definidas como storage.buckets.update. Se a conta de serviço não tiver essa permissão, o Citrix Virtual Apps and Desktops ignora os erros e prossegue com o processo de criação do catálogo. Sem essa permissão, o tamanho dos logs de compilação aumenta e exige limpeza manual.

Habilitar acesso privado do Google

Quando uma VM não possui um endereço IP externo atribuído à sua interface de rede, os pacotes são enviados apenas para outros destinos de endereços IP internos. Ao habilitar o acesso privado, a VM se conecta ao conjunto de endereços IP externos usados pela API do Google e serviços associados.

Nota:

Seja o acesso privado do Google ativado, todas as VMs com e sem endereços IP públicos devem ser capazes de acessar as APIs Públicas do Google, especialmente se dispositivos de rede de terceiros tiverem sido instalados no ambiente.

Para garantir que uma VM em sua sub-rede possa acessar as APIs do Google sem um endereço IP público para provisionamento MCS:

1. No Google Cloud, acesse a configuração de rede VPC.
2. Na tela de detalhes da Sub-rede, ative o acesso privado do Google.

Para obter mais informações, consulte Configurando o Acesso Privado do Google.

Importante:

Se sua rede estiver configurada para impedir o acesso da VM à Internet, certifique-se de que sua organização assuma os riscos associados à habilitação do acesso privado do Google para a sub-rede à qual a VM está conectada.

Onde ir a seguir

• Instalar componentes principais
• Instalar VDAs
• Criar um site
• Para criar e gerenciar uma conexão em ambientes Google Cloud, consulte Conexão com ambientes Google Cloud

Mais informações

• Criar e gerenciar conexões e recursos
• Criar catálogos de máquinas(/pt-br/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-create.html)