Como acessar dispositivos de gerenciamento

Nesta página, descrevemos as etapas para se conectar a dispositivos de gerenciamento para suas nuvens privadas.

Antes de se conectar a dispositivos de gerenciamento, é preciso ter conectividade de rede da máquina cliente para a rede do VMware Engine. Estabeleça a conectividade de rede usando uma das seguintes opções:

Conecte-se por uma VM na rede VPC usada ao criar a nuvem privada. Use o endereço IP interno ou o FQDN do dispositivo de gerenciamento.
Como se conectar da rede local à rede VPC

Pré-requisitos da CLI do Google Cloud e da API

Para usar a ferramenta de linha de comando gcloud ou a API para gerenciar os recursos do VMware Engine, recomendamos configurar as ferramentas conforme descrito abaixo.

gcloud

Defina o ID do projeto padrão:
```
gcloud config set project PROJECT_ID
```

Defina uma região e uma zona padrão.

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Para mais informações sobre a ferramenta gcloud vmware, consulte os documentos de referência do SDK Cloud.

API

Os exemplos de API neste conjunto de documentação usam a ferramenta de linha de comando cURL para consultar a API. Um token de acesso válido é necessário como parte da solicitação cURL. Há muitas maneiras de conseguir um token de acesso válido. As etapas a seguir usam a ferramenta gcloud para gerar um token de acesso:

Faça login no Google Cloud:
```
gcloud auth login
```

Gere o token de acesso e exporte para o TOKEN:

export TOKEN=`gcloud auth print-access-token`

Verifique se o TOKEN está definido corretamente:
```
echo $TOKEN
```

Use agora o token de autorização nas solicitações para a API. Exemplo:

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

Os exemplos de código Python nesta documentação usam a biblioteca do VMware Engine para se comunicar com a API. Para usar essa abordagem, a biblioteca precisa estar instalada e o Application Default Credentials precisa estar configurado.

Faça o download e instale a biblioteca Python:
```
pip install google-cloud-vmwareengine
```
Configure as informações do ADC executando estes comandos no shell:
```
gcloud auth application-default login
```
Ou use um arquivo de chave da conta de serviço:
```
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
```

Para mais informações sobre a biblioteca, acesse a página de referência ou veja os exemplos de código no GitHub.

Para acessar um dispositivo de gerenciamento da nuvem privada, faça o seguinte:

Acessar detalhes da conexão dos dispositivos de gerenciamento

Console

Para conseguir o URL de um dispositivo de gerenciamento usando o console do Google Cloud, siga estas etapas:

Acesse o portal do Google Cloud VMware Engine.
Clique em Nuvens privadas.
Selecione a nuvem privada que você quer acessar.
Na página de detalhes da nuvem privada, selecione a guia Dispositivos de gerenciamento.
Clique na coluna URL do vCenter Server ou NSX Manager.

gcloud

Para ver os detalhes da conexão com um dispositivo de gerenciamento usando a Google Cloud CLI, faça o seguinte:

Para mostrar os URLs do dispositivo de gerenciamento, execute o comando gcloud vmware private-clouds describe.

gcloud vmware private-clouds describe \
 --private-cloud=PRIVATE_CLOUD_ID \
 --project=PROJECT_ID \
 --location=REGION

Substitua:

PRIVATE_CLOUD_ID: o ID de uma nuvem privada da nuvem privada para esta solicitação.
PROJECT_ID: o nome do projeto para esta solicitação.
REGION: a região da nuvem privada. Se for uma nuvem privada estendida, especifique a zona para essa nuvem privada.

API

Para mostrar os detalhes da conexão do dispositivo de gerenciamento usando a API VMware Engine, faça uma solicitação GET:
```
    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateCloud/PRIVATE_CLOUD_ID"
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- REGION: a região da nuvem privada. Se essa for a nuvem privada estendida, especifique a zona para essa nuvem privada.
- PRIVATE_CLOUD_ID: o ID de uma nuvem privada da nuvem privada para esta solicitação.

Receber credenciais para dispositivos de gerenciamento

Depois de criar uma nuvem privada, é possível gerar credenciais para os dispositivos de gerenciamento dessa nuvem privada, como o vCenter Server e o NSX Manager. Para acessar esses dispositivos na sua nuvem privada pela primeira vez, use o ID de usuário e a senha gerados pelo console do Google Cloud.

Para adicionar mais usuários aos seus appliances do vCenter Server ou NSX Manager, entre em contato com o Cloud Customer Care.

Console

Para receber a senha de um dispositivo de gerenciamento usando o console do Google Cloud, siga estas etapas:

Acesse o portal do Google Cloud VMware Engine.
Clique em Nuvens privadas.
Selecione a nuvem privada que você quer acessar.
Na página de detalhes da nuvem privada, selecione a guia Dispositivos de gerenciamento.
Na coluna Informações de login do vCenter Server ou NSX Manager, clique em Detalhes da chave.
Copie as credenciais do vCenter Server ou NSX Manager do prompt exibido.

gcloud

Para receber a senha de um dispositivo de gerenciamento usando a CLI do Google Cloud, faça o seguinte:

Para mostrar as credenciais de usuário do vCenter, execute o comando gcloud vmware private-clouds vcenter credentials describe.

gcloud vmware private-clouds vcenter credentials describe \
 --private-cloud=PRIVATE_CLOUD_ID \
 --project=PROJECT_ID \
 --location=REGION

Para mostrar as credenciais de usuário do NSX, execute o comando gcloud vmware private-clouds nsx credentials describe.

gcloud vmware private-clouds nsx credentials describe \
 --private-cloud=PRIVATE_CLOUD_ID \
 --project=PROJECT_ID \
 --location=REGION

Substitua:

PRIVATE_CLOUD_ID: o ID de uma nuvem privada da nuvem privada para esta solicitação.
PROJECT_ID: o nome do projeto para esta solicitação.
REGION: a região da nuvem privada. Se for uma nuvem privada estendida, especifique a zona para essa nuvem privada.

API

Para mostrar credenciais de usuário do vCenter usando a API VMware Engine, faça uma solicitação GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateCloud/PRIVATE_CLOUD_ID/showVcenterCredentials"

Para mostrar credenciais de usuário do NSX usando a API VMware Engine, faça uma solicitação GET:
```
    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateCloud/PRIVATE_CLOUD_ID/showNsxCredentials"
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- REGION: a região da nuvem privada. Se essa for a nuvem privada estendida, especifique a zona para essa nuvem privada.
- PRIVATE_CLOUD_ID: o ID de uma nuvem privada da nuvem privada para esta solicitação.

Redefinir credenciais de acesso

Se você perder as credenciais do vCenter Server ou NSX Manager, poderá redefinir a senha dos seus dispositivos de gerenciamento para sua nuvem privada usando a CLI do Google Cloud ou o Google Cloud VMware Engine fazendo o seguinte:

Console

Para redefinir a senha de um dispositivo de gerenciamento usando o console do Google Cloud, siga estas etapas:

Siga as etapas na seção Receber credenciais para dispositivos de gerenciamento.
No prompt exibido contendo suas credenciais de acesso, clique em Redefinir senha.

gcloud

Para redefinir a senha de um dispositivo de gerenciamento usando a CLI do Google Cloud, faça o seguinte:

Execute o comando gcloud vmware private-clouds vcenter credentials reset para redefinir as credenciais do usuário do vCenter:

gcloud vmware private-clouds vcenter credentials reset \
 --private-cloud=PRIVATE_CLOUD_ID \
 --project=PROJECT_ID \
 --location=REGION

Execute o comando gcloud vmware private-clouds nsx credentials reset para redefinir as credenciais do usuário do vCenter:

gcloud vmware private-clouds nsx credentials reset \
 --private-cloud=PRIVATE_CLOUD_ID \
 --project=PROJECT_ID \
 --location=REGION

Substitua:

PRIVATE_CLOUD_ID: o ID de uma nuvem privada da nuvem privada para esta solicitação.
PROJECT_ID: o nome do projeto para esta solicitação.
REGION: a região da nuvem privada. Se for uma nuvem privada estendida, especifique a zona para essa nuvem privada.

API

Para redefinir as credenciais do usuário do vCenter usando a API VMware Engine, faça uma solicitação GET:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateCloud/PRIVATE_CLOUD_ID/resetVcenterCredentials"

Para redefinir as credenciais do usuário do vCenter usando a API VMware Engine, faça uma solicitação GET:
```
    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/privateCloud/PRIVATE_CLOUD_ID/resetNsxCredentials"
 
```
Substitua:
- PROJECT_ID: o nome do projeto para esta solicitação.
- REGION: a região da nuvem privada. Se essa for a nuvem privada estendida, especifique a zona para essa nuvem privada.
- PRIVATE_CLOUD_ID: o ID de uma nuvem privada da nuvem privada para esta solicitação.