Implantação do PowerShell para Google Cloud Platform

Os comandos do PowerShell são usados para implantar o Unified Access Gateway 2103 ou posterior para Compute Engine no Google Cloud Platform.

Sistemas operacionais e versões do PowerShell recomendados

Procedimento

1. Preparar a máquina cliente
2. Preparar o ambiente do Google Cloud Platform
3. Carregue a imagem do Unified Access Gateway para o Google Cloud Platform
4. Preparar um arquivo .ini para a implantação no Google Cloud Platform
5. Implantar no Compute Engine

Etapa 1: preparar a máquina cliente para a implantação do PowerShell

Instale os utilitários do Google Cloud na máquina Cliente.

1. Instale o gsutil. Para obter instruções sobre como instalar a ferramenta gsutil no Windows e no Ubuntu, consulte Instalação de gsutil como parte da CLI do Google Cloud na documentação do Google Cloud.

2. Para um computador Windows, execute o comando do PowerShell a seguir com direitos administrativos.

   Install-Package 7Zip4PowerShell
   

Etapa 2: preparar o ambiente do Google Cloud Platform

Use um projeto do Google Cloud. Este projeto deve ser configurado com redes VPC, as redes de sub-rede correspondentes e regras de firewall. Para obter mais informações, consulte a Documentação do Google Cloud.

Pré-requisitos

• Esteja ciente dos conceitos do Google Cloud Platform.
• Verifique se você tem as permissões necessárias para criar ou modificar recursos como imagens, rede VPC, sub-rede, regras de Firewall e assim por diante, no projeto do Google Cloud.
• A API do Compute Engine deve estar ativada.

Procedimento

1. Use um projeto do Google Cloud.

   Opção	Ação
   Novo projeto	No Google Cloud Console, navegue até a página Seletor de projetos. Crie um projeto do Google Cloud.
   Projeto existente	Se um projeto já estiver disponível e ativo, você poderá usar o projeto existente.

2. Crie uma rede de Virtual Private Cloud (VPC) para cada NIC.

   Cada NIC no Unified Access Gateway usa uma rede VPC exclusiva e uma sub-rede nessa rede.

   Se você optar por não criar uma rede VPC, apenas uma única NIC do Unified Access Gateway poderá ser implantada. O dispositivo do Unified Access Gateway, quando implantado no Compute Engine, usa a rede VPC padrão disponível no Google Cloud Platform.

   Por exemplo, na imagem a seguir, duas redes VPC, uag-front-vpc e uag-back-vpc, são criadas no Google Cloud Console. Essas redes VPC têm uag-front-network e uag-back-network como sub-redes, respectivamente. Um dispositivo do Unified Access Gateway com duas NIC pode ser implantado para usar essas duas sub-redes para front-end voltado para a Internet e uma rede de sub-rede separada para conexões back-end.

   

   Nota: Você também pode configurar o Unified Access Gateway com redes VPC compartilhadas. Nesse caso, instâncias do Unified Access Gateway implantadas no projeto de serviço são anexadas às redes VPC compartilhadas criadas e gerenciadas no projeto do host. Cada interface de rede (NIC) no Unified Access Gateway pode ser configurada de forma independente para usar a rede VPC compartilhada ou a rede VPC local. Para obter mais informações, consulte Configuração de VPC compartilhada na documentação do Google Cloud.

3. Anote o nome da sub-rede criado.

   O nome da sub-rede em uma rede VPC é usado no arquivo .ini durante a implantação do Unified Access Gateway usando o PowerShell.

4. Para permitir o acesso à porta TCP e UDP a dispositivos do Unified Access Gateway na VPC acessível pela Internet, crie o número necessário de entradas de firewall.

   Importante: O acesso remoto SSH ao Unified Access Gateway na porta TCP 22 da Internet deve ser cuidadosamente restrito no firewall. Se o acesso SSH for necessário, a regra de firewall deverá permitir esse acesso somente de um endereço IP de origem específico ou de uma máquina virtual jumpbox na nuvem, por meio da qual o acesso pode ser controlado.

   Por exemplo, na imagem do Google Cloud Console a seguir, uma regra de firewall chamada uag-horizon-protocols é criada na rede VPC voltada para a Internet uag-front-vpc. Essa regra de firewall se aplica a todas as instâncias conectadas à rede uag-front-vpc e permite tráfego TCP e UDP de entrada em portas especificadas da Internet pública.

   

Etapa 3: carregar a imagem do Unified Access Gateway para o Google Cloud Platform

Para implantar uma instância do Unified Access Gateway no Compute Engine, você deve carregar uma imagem de disco do dispositivo do Unified Access Gateway no Google Cloud Platform.

1. No Omnissa Customer Connect, acesse o arquivo Unified Access Gateway (UAG) for vSphere, AWS e Google Cloud e clique em BAIXAR AGORA.
   Um arquivo zip euc-unified-access-gateway-x.x.x.xxxxxxxxx.ova é baixado na sua máquina local.

2. Abra uma janela de comando do PowerShell e execute o comando a seguir para extrair o arquivo .vmdk do arquivo .ova baixado anteriormente.

   • ova-filename é o arquivo de imagem .ova que é baixado do Customer Connect.
   • target-location é o local no qual o arquivo .vmdk é extraído.

   Windows	Ubuntu
   expand-7zip ova-filename target-location Por exemplo, euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova é o arquivo baixado, em que 22-12 é o número da versão e 42741890 é o número da compilação. Para extrair o arquivo .vmdk para C:\temp, execute o seguinte comando: expand-7zip C:\temp\euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova C:\temp\	tar -xvf ova-filename Por exemplo, tar -xvf euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova

3. Defina as variáveis a seguir.

   • $gcImageFile é o nome do arquivo .vmdk extraído na etapa 2.
   • $gcImageFolder é o caminho da pasta do arquivo .vmdk. Por exemplo:

   
   $gcImageFolder="C:\temp"
   $gcImageFile="euc-unified-access-gateway-22.12.0.0-42741890-system.vmdk"
   $gcBucket="uag-appliance-images"
   $gcImageName=$gcImageFile.Replace("-system.vmdk","").Replace(".", "-")
   gcloud auth login
   gcloud config set project "my-project"
   
   

4. Crie um bucket de armazenamento do Google Cloud.

   Nota: Você também pode implantar o Unified Access Gateway com a imagem de processamento hospedada em outro projeto do Google Cloud. Nesse caso, especifique o nome da imagem de processamento ($gcImageName) e a ID do Projeto de hospedagem durante a implantação do Unified Access Gateway.

   Execute esse comando para criar um bucket de armazenamento no mesmo projeto.

   gsutil mb -l us-east1 gs://$gcBucket
   

   Execute esse comando para criar um bucket de armazenamento em um projeto diferente.

   gsutil mb -l us-east1 gs://$gcBucket -p my-image-hosting-project
   

5. Carregue a imagem .vmdk no bucket de armazenamento do Google Cloud usando o seguinte comando:

   gsutil cp $gcImageFolder\$gcImageFile gs://$gcBucket
   

6. Crie a imagem do dispositivo no Compute Engine do .vmdk carregado.

   Execute esse comando para importar a imagem no mesmo projeto.

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk
   

   Execute esse comando para importar a imagem em um projeto diferente.

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --project my-image-hosting-project
   

   Nota: Ao importar uma imagem de processamento, você pode especificar a sub-rede a ser usada para as VMs temporárias criadas pela ferramenta de importação. Use o sinalizador --subnet conforme mostrado no exemplo a seguir.

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --subnet default
   

   Para obter mais informações sobre esses comandos, consulte a documentação do Google Cloud SDK.

   Considerando o exemplo mencionado nas etapas anteriores, a imagem do dispositivo criada no Compute Engine é euc-unified-access-gateway-22-12-0-0-42741890, em que 22-12 é o número da versão e 42741890 é o número da compilação.

Etapa 4: preparar um arquivo .ini para a implantação no Google Cloud Platform

O script de implantação Compute Engine do PowerShell para o Unified Access Gateway lê todas as definições de configuração de um arquivo de configuração .ini. Esta seção descreve o formato de arquivo .ini e mostra exemplos das configurações que podem ser usadas para a implantação.

A maioria das seções do arquivo são idênticas às .ini configurações de .ini padrão para o Unified Access Gateway compatíveis com todas as outras implantações de hypervisor. Para obter mais informações sobre o arquivo .ini, consulte a seção Usar o PowerShell para implantar o dispositivo do Unified Access Gateway.

1. Defina as configurações necessárias na seção [Geral]. Consulte Parâmetros de implantação do PowerShell.

   Nota: para implantações do Google Cloud Platform, as seguintes configurações na seção [Geral] não são usadas:

   • diskMode
   • ds
   • folder
   • netInternet
   • netManagementNetwork
   • netmask0, netmask1, netmask2
   • netBackendNetwork
   • source
   • target
   • ip0, defaultGateway, netmask0, ipmode0
   • v6ip0, v6ipprefix0, v6DefaultGateway

2. No arquivo .ini, adicione um novo grupo, [GoogleCloud] e as configurações necessárias específicas para o Google Cloud Platform.

A tabela a seguir lista as configurações (Nome do Valor) necessárias para a implantação do Google Cloud Platform.

sharedVpcForSubnet0=true
sharedVpcForSubnet1=false
sharedVpcForSubnet2=false

Exemplo 1: definição de arquivo INI para implantar o Unified Access Gateway no Google Cloud Platform

[General]
name=uag1
deploymentOption=onenic
sshEnabled=true

[GoogleCloud]
projectId=my-project
imageName=euc-unified-access-gateway-22-12-0-0-42741890
zone=us-central1-a
subnet0=uag-front-network

[Horizon]
proxyDestinationUrl=https://myhorizon.example.com

Exemplo 2: definição de arquivo INI para implantar o Unified Access Gateway no Google Cloud Platform

[General]
name=uag2
deploymentOption=twonic
sshEnabled=true
routes1=10.20.0.0/16 10.2.0.1

[GoogleCloud]
projectId=my-project
imageName=euc-unified-access-gateway-22-12-0-0-42741890
imageProjectId=my-image-hosting-project
zone=us-central1-a
vpcHostProjectId=my-sharedvpc-host-project
subnet0=uag-front-network
sharedVpcForSubnet0=true
subnet1=uag-back-network
sharedVpcForSubnet1=false

[Horizon]
proxyDestinationUrl=https://myhorizon.example.com

Etapa 5: implantar no Compute Engine

Você pode implantar o Unified Access Gateway no Compute Engine usando o comando uagdeploygce.ps1 do PowerShell. Esse comando obtém todas as definições de configuração de um arquivo .ini e implanta uma instância do Unified Access Gateway.

Se qualquer instância existente no Compute Engine tiver o mesmo nome especificado na seção Geral do arquivo .ini, o script do PowerShell removerá a instância existente durante a implantação e criará uma nova instância do Unified Access Gateway com o mesmo nome. Essa substituição ajuda ao atualizar um dispositivo do Unified Access Gateway ou a reimplantar o dispositivo com configurações atualizadas.

1. No Omnissa Customer Connect, vá para o arquivo de Scripts do PowerShell do Unified Access Gateway (UAG) e clique em BAIXAR AGORA.
   Um arquivo zip uagdeploy-xx.xx.x.x-xxxxxxxx é baixado na sua máquina local.

2. Extraia os arquivos do arquivo zip. Certifique-se de que os scripts do PowerShell a seguir estejam disponíveis em seu computador.
   uagdeploygce.ps1 e uagdeploy.psm1 na máquina Windows.

3. Inicie uma janela de comando do PowerShell e altere o diretório para a pasta que contém os scripts baixados.

4. Para implantar o Unified Access Gateway no Compute Engine, execute o seguinte:

   1. Se você estiver atualizando para uma versão posterior do Unified Access Gateway, edite o arquivo .ini para atualizar a configuração imageName para o novo nome da imagem que é carregado para o Compute Engine em uma das tarefas anteriores.

      Todos os outros parâmetros de configuração no arquivo .ini devem permanecer os mesmos.

   2. Execute o seguinte comando dependendo de você escolher o modo interativo ou não interativo:

      Modo	Comando
      Interativo	.\uagdeploygce.ps1 <ini-filename>.ini <ini-filename> é o nome do arquivo .ini preparado nas tarefas anteriores. Por exemplo: .\uagdeploygce.ps1 uag1.ini uag1.ini é o nome do arquivo usado nas tarefas anteriores.
      Não interativo	.\uagdeploygce.ps1 <ini-filename> <root-pwd> <admin-pwd> <ceip-yes-no> .\uagdeploygce.ps1 <ini-filename> <secret> <admin-pwd> yes <ini-filename> é o nome do arquivo .ini preparado nas tarefas anteriores. Se as senhas forem especificadas na linha de comando, conforme mostrado no comando, use o comando do PowerShell Clear-History depois de implantar o Unified Access Gateway. Se a senha for fraca, a implantação falhará. A senha deve conter um dos caracteres ! @ # $ % * ( ).

      Se você executar o comando uagdeploygce.ps1 novamente, a instância do Unified Access Gateway anterior e os recursos associados serão excluídos e substituídos por uma nova instância com o mesmo nome. O novo arquivo .ini deve ter todos os parâmetros de configuração necessários para que o dispositivo do Unified Access Gateway appliance esteja pronto para produção na primeira inicialização.

Para obter mais informações sobre as exigências de senha do usuário raiz e do administrador, consulte Requisitos de senha.

O que fazer depois

Depois que o Unified Access Gateway é implantado no Compute Engine e todas as configurações são aplicadas, os metadados usados para aplicar as definições de configuração do dispositivo do Unified Access Gateway no Google Cloud devem ser removidos. Para remover os metadados, use os seguintes comandos, conforme mostrado no exemplo:

$uagName=uag1
$zone=us-central1-a
$projectId=my-project
gcloud compute instances remove-metadata $uagName --zone=$zone --project $projectId --keys "user-data"