> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/cloud-deployment/google-cloud-platform.md).

# Plataforma Google Cloud

Implante o Navixy On-Premise na Plataforma Google Cloud. Crie uma máquina virtual com as especificações necessárias, configure chaves SSH e conecte-se pelo navegador ou cliente.

A implantação da infraestrutura para utilizar a solução Navixy On-Premise exige uma seleção cuidadosa do local inicial. Se você decidir optar por uma plataforma em nuvem, uma das soluções mais populares é o Google Cloud Platform (GCP). É uma plataforma confiável, comprovada e amplamente reconhecida, que permite iniciar máquinas virtuais com facilidade e pouco esforço. Além disso, oferece tanta flexibilidade de personalização, Segurança e tolerância a falhas quanto outras plataformas populares.

<div align="center"><img src="https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-89980904f1f72e0f2727cbd8486c528bf9bba0d6%2Fimage-20231228-134130.png?alt=media" alt="GCP"></div>

A seguir estão as etapas básicas para implantar uma máquina virtual funcional na qual você poderá instalar a solução Navixy On-Premise. Se precisar ajustar seu ambiente de nuvem e fazer configurações mais avançadas, consulte a [documentação do Google Cloud](https://cloud.google.com/docs/).

## Primeiros passos

A primeira coisa a fazer é se cadastrar no serviço, escolhendo uma conta individual ou empresarial conforme seus objetivos. Se estiver se cadastrando pela primeira vez, você poderá aproveitar um período de avaliação de 90 dias e créditos de US$ 300, para continuar o trabalho sem pressa. No entanto, lembre-se de que, quando estiver pronto para iniciar sua instância como uma solução empresarial, será necessário converter sua conta de avaliação gratuita em uma conta completa. Caso contrário, você corre o risco de perder sua instância após o término do período de 90 dias.

Depois de concluir o cadastro, você precisará selecionar ou criar seu projeto. Por padrão, um novo projeto já é criado, mas você pode renomeá-lo ou criar outro.

![](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-9b025ae44ab45e6e4d1be105339fe7d2ebd84e31%2Fimage-20231228-141628.png?alt=media\&token=2777a895-21be-48e1-bb16-755b2071945d)

![Projeto do GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-152858fd37eafdea872a115307ce65d95c1a613d%2Fimage-20231228-141659.png?alt=media\&token=39ebf0dc-8850-41da-9cd1-004182e56338)

Depois que o projeto for criado, você poderá criar sua nova máquina virtual na nuvem.

## Máquina virtual

Para criar uma nova máquina virtual, selecione a opção “Criar uma VM” no painel do projeto, na seção “Produtos”.

![Máquina virtual do GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-1d5cbfbea15edd498286798e4b113ba36904ee77%2Fimage-20231228-145129.png?alt=media\&token=e74b2ee6-6a9b-4e52-ab60-a0cb5987d108)

Outra opção é acessar “Compute Engine” > “Instâncias de VM” no menu de navegação.

![Máquina virtual do GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-db36e184f714abd6d8c0617968bbcbce30085c73%2Fimage-20231228-145315.png?alt=media\&token=b85e885b-52db-44c6-9c64-da2252e34bef)

Em seguida, será solicitado que você ative a API do Compute Engine — essa etapa é obrigatória para trabalhar com máquinas virtuais.

![Compute Engine do GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-0b7d4bef28857e2e3648f4dfc4e6d8f1a120275e%2Fimage-20231228-145643.png?alt=media\&token=eda768b5-ad55-409e-93f9-12c9c17c62a9)

Depois que a API for ativada, você será direcionado ao menu de **Instâncias de VM** , onde poderá criar suas máquinas virtuais.

Clique em **CRIAR INSTÂNCIA**.

![Criar instância no GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-383891b7969a4f6255537cf7019b430c54a816d5%2Fimage-20240116-123112.png?alt=media\&token=176cabd5-1d11-4f63-b40b-93583fefec7f)

Aqui, você precisará fazer o seguinte.

1. Escolha um nome — pode ser qualquer nome, mas é recomendável que ele indique a finalidade da máquina. Opcionalmente, você pode atribuir rótulos e etiquetas para organizar seu espaço de trabalho.\ <img src="https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-86834db07de00d6f95eff8570428876f4e6739b5%2Fimage-20240117-131953.png?alt=media" alt="GCP create instance" data-size="original">
2. Selecione uma região e uma zona — elas determinam a localização física do centro de dados que hospedará seu futuro servidor. É preferível escolher uma região o mais próxima possível dos seus clientes. Essa configuração afeta ligeiramente o custo.\ <img src="https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-36a024a52d54a665382c74b535888982a7dfaf72%2Fimage-20240117-132016.png?alt=media" alt="GCP instance region" data-size="original">
3. Selecione a configuração da máquina. Nesta seção, você escolhe a configuração do servidor de acordo com as tarefas e as cargas previstas. Você encontra mais informações sobre as configurações possíveis da instância na [documentação do Google Cloud Platform](https://cloud.google.com/compute/docs/instances). Para instâncias grandes e com alta carga, recomenda-se selecionar uma configuração otimizada para computação. O tipo e a configuração da instância afetam bastante o custo.\
   ![GCP instance configuration](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-9bde40c4fbd25548e14a9b0020c4b19e15af6e15%2Fimage-20240117-132153.png?alt=media\&token=c2e8b70a-8e8c-46b4-8756-b5e5fd563a67)
4. Configure o disco de inicialização. Aqui, você seleciona a versão do sistema operacional (recomenda-se Ubuntu 22.04 ou posterior), o tipo de disco (recomenda-se SSD) e a capacidade do disco (que deve ser calculada de acordo com os [requisitos de hardware do servidor](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/requirements/server-hardware.md)).\
   ![GCP disk](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-bf4876f2b41278c9caffae72d0f7c7a77a131d5c%2Fimage-20240117-132329.png?alt=media\&token=997f9e1e-fbcc-40b6-81eb-971d8856952f)
5. Configure as definições de firewall. Basicamente, é necessário permitir o tráfego HTTP e HTTPS.\
   ![GCP firewall settings](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-7d7124d761046472c6f9449153d8699306eef221%2Fimage-20240117-132502.png?alt=media\&token=a5d81210-c0c2-4a42-9eee-cb40b411bb5d)
6. Faça outras configurações conforme seus requisitos específicos.
7. Clique em **CRIAR**. Sua nova instância na nuvem será criada.

## Conexão

Depois que a máquina virtual for criada, ela receberá um endereço IP interno e outro externo. No entanto, mesmo tendo um endereço externo, você não poderá usá-lo imediatamente para se conectar via SSH.

A instância na nuvem permite conexões usando chaves SSH. A maneira mais fácil de configurar a conexão é fornecer ao servidor uma chave que você tenha em seu computador.

{% hint style="info" %}
Se você não tiver chaves SSH em seu computador, crie uma usando o OpenSSH (Linux/MacOS) ou o PuTTYgen (Windows).
{% endhint %}

Primeiro, estabeleça uma conexão SSH pelo navegador, disponibilizada no Google Console. Clique no botão “SSH” à direita da instância recém-criada.

![Conexão SSH do GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-6dff259a4cf5abad98e1324be09ce3909f5430df%2Fimage-20240117-133809.png?alt=media\&token=64e598b0-4cd8-46db-833a-51adde4afa5a)

Uma nova janela do navegador será aberta e uma conexão com o servidor será estabelecida. Siga as instruções na tela — em determinado momento, o console fará a autorização. Depois disso, você entrará no sistema Linux com seu nome de usuário do Google.

![SSH pelo navegador no GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-753dfa9bebe5410cc080019ee6fc60366bf1a9e0%2Fimage-20240117-134819.png?alt=media\&token=c14d00bb-3faa-475c-8c45-a0fae964f594)

Seu novo usuário tem privilégios de sudo e acesso root, então você pode fazer as configurações necessárias usando essa conta ou executar `sudo -i` e realizar todas as ações seguintes como root.

Agora, você precisa selecionar um usuário para o acesso SSH remoto. O sistema tem um usuário padrão, `ubuntu`. Vamos configurá-lo neste exemplo, mas você pode criar qualquer usuário de sua preferência para essa finalidade.

Acesse o arquivo `/home/ubuntu/.ssh/authorized_keys`. Se esse arquivo ou diretório não existir, você precisará criá-lo primeiro. Abra o arquivo para edição. Copie a parte pública da sua chave SSH para esse arquivo — ela deve ser precedida por `ssh-rsa` e finalizada com qualquer nome que a diferencie.

![Chave SSH do GCP](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-95484ffcd11ecc082c2dc6b39e7140f6a0d0f0d1%2Fimage-20240117-141222.png?alt=media\&token=81b2a4da-7239-4f48-a051-0b135f864c9c)

Salve o arquivo.

Reinicie o serviço SSH: `sudo systemctl restart ssh`

Agora você pode usar qualquer cliente SSH (por exemplo, PuTTY) para se conectar à instância de nuvem recém-criada — lembre-se de usar sua chave privada para autenticação.

## Implantação da plataforma Navixy

Agora você tem um servidor em nuvem funcional que pode acessar remotamente.

Acesse a seção de instruções correspondente e execute [Instalação da plataforma Navixy On-Premise](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/installation/advanced-installation.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/cloud-deployment/google-cloud-platform.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
