Configurar o backup com Google Drive
Caminho: Opa! Store → Google Drive → Instalar
Visão geral
O app Google Drive permite que você salve os backups do Opa! Suite numa pasta da sua conta Google. Assim, as cópias de segurança ficam fora do servidor e podem ser restauradas se algo acontecer com ele.
A conexão usa credenciais que você cria no Google Cloud, num projeto da sua própria conta. A configuração tem duas partes: preparar o projeto no Google Cloud e instalar o app no Opa! Suite.
O app é gratuito no Opa! Suite. O espaço usado no Google Drive segue o plano da sua conta Google.
Pré-requisitos
- Permissão para visualizar o Opa! Store e a permissão Backup no seu grupo de permissões.
- Conta Google em que os backups serão salvos, com espaço livre no Google Drive.
- Endereço do seu Opa! Suite (o domínio que aparece no navegador), para cadastrar no Google Cloud.
Passo a passo
Preparar o projeto no Google Cloud
As telas abaixo são do Google Cloud e podem mudar. Em caso de dúvida, consulte a documentação do Google.
- Acesse o Google Cloud console com a conta Google que vai guardar os backups.
- Crie um novo projeto e dê um nome a ele (ex.: "Opa Suite Backup"). Depois, selecione esse projeto.
- Ative a API do Google Drive: acesse APIs e serviços → Biblioteca, pesquise Google Drive API e clique em Ativar.
- Configure a tela de consentimento: acesse Plataforma de autenticação do Google → Branding e clique em Começar. Informe o nome do app e o e-mail de suporte. Em Público-alvo, escolha Externo. Preencha as informações de contato, aceite a política e clique em Criar.
- Publique o app: em Plataforma de autenticação do Google → Público-alvo, clique em Publicar app e confirme.
- Crie as credenciais: acesse Plataforma de autenticação do Google → Clientes e clique em Criar cliente.
- Tipo de aplicativo: Aplicativo da Web.
- Nome: um nome para identificar a credencial.
- Origens JavaScript autorizadas: o endereço do seu Opa! Suite, com
https://(ex.:https://suaempresa.com.br). - URIs de redirecionamento autorizados: o endereço do seu Opa! Suite seguido de
/apps/google-drive/oauth(ex.:https://suaempresa.com.br/apps/google-drive/oauth). O Opa! Suite mostra esse endereço pronto para copiar na janela de instalação.
- Clique em Criar e copie o ID do cliente e a Chave secreta do cliente.
Enquanto o app do Google Cloud está em teste, o Google libera o acesso por apenas 7 dias (documentação do Google). Depois disso, os backups param de ser enviados. Por isso, publique o app no passo 5.
Instalar o app no Opa! Suite
- Acesse Opa! Store → Google Drive e clique em Instalar. A janela Instalar Google Drive abre com duas etapas.
- Na etapa Informações principais, preencha:
- Nome do App: nome para identificar a integração. Use só letras e números, sem espaços (ex.: "BackupDrive").
- ID do cliente e Chave secreta do cliente: os dados copiados no Google Cloud.
- Clique em Continuar.
- Na etapa Permissão, clique em Conceder acesso. Uma janela do Google abre.
- Entre com a mesma conta Google do projeto e autorize o acesso ao Google Drive. Se o Google avisar que o app não foi verificado, siga pelas opções avançadas para continuar, já que o app é o seu próprio projeto (documentação do Google).
- A janela fecha sozinha e o campo Código de verificação é preenchido. Se a janela não fechar, feche manualmente e volte ao Opa! Suite.
- Em Pasta para salvar arquivos, informe o nome de uma pasta do Google Drive. Pode ser uma pasta que já existe ou o nome de uma nova.
- Clique em Instalar.
Resultado esperado
O app aparece como Instalado e o botão Acessar abre a lista de integrações do Google Drive, com o Nome e a Pasta para salvar arquivos. Nessa lista, o botão Instalar permite conectar outra conta.
Ao abrir a integração, você encontra as abas Cadastro, Preferências e Backups e os botões Testar App, Baixar arquivo de configuração e Desinstalar App. Clique em Testar App para conferir a conexão: o Opa! Suite mostra Conectado com sucesso! e quanto do armazenamento está em uso.
A partir daí, você pode fazer backups manuais na aba Backups ou agendá-los em Rotinas automáticas.
Configurações disponíveis
Cadastro
| Campo | O que faz |
|---|---|
| ID do cliente | ID da credencial criada no Google Cloud. |
| Chave secreta do cliente | Chave da credencial. Para trocar, digite a nova. Em branco, a atual é mantida. |
Preferências
| Campo | O que faz |
|---|---|
| Receber relatórios de backup por e-mail | Envia um relatório quando um backup é criado, restaurado ou excluído. Só funciona se a integração de e-mail (SMTP) estiver instalada. |
| E-mail para receber relatórios de backup | Para onde vão os relatórios. Obrigatório quando a opção acima está ativa. |
| Período que arquivos de backup devem ser mantidos | Quantos dias os backups ficam no Google Drive. Em branco, nada é apagado. |
| Formato de exclusão automática após período | Enviar para a lixeira ou Deletar permanentemente, para os backups que passam do período. |
| Pasta para salvar arquivos | A pasta do Google Drive em que os backups são salvos. |
Sempre que você salva o Cadastro ou as Preferências, o Opa! Suite oferece o download do arquivo de configuração. Guarde-o fora do servidor: sem ele, não é possível reconectar a integração e acessar os backups numa instalação nova.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Aparece O nome do aplicativo deve conter apenas letras e números | Tire espaços, acentos e símbolos do Nome do App. |
| O Google mostra erro de redirecionamento ao clicar em Conceder acesso | O endereço em URIs de redirecionamento autorizados está diferente do mostrado pelo Opa! Suite. Copie o endereço da janela de instalação e cadastre de novo no Google Cloud. |
| A instalação falha depois de Conceder acesso | Confira o ID do cliente e a Chave secreta do cliente e faça a autorização de novo, com a mesma conta Google do projeto. |
| Os backups pararam depois de alguns dias | O app do Google Cloud ficou em modo de teste e a autorização expirou. Publique o app em Público-alvo e instale a integração de novo para gerar uma nova autorização. |
| Testar App mostra Erro ao verificar o app | A conexão com o Google Drive falhou. Confira se a Google Drive API continua ativa no projeto. Veja também Erros frequentes em integrações de backup. |
Boas práticas
- Use uma conta Google da empresa, não a conta pessoal de um colaborador.
- Preencha o Período que arquivos de backup devem ser mantidos para o Google Drive não encher.
- Guarde o arquivo de configuração fora do servidor e baixe de novo sempre que alterar a integração.
- Agende os backups fora do horário de atendimento.