Configurar o backup com Amazon S3
Caminho: Opa! Store → Amazon S3 → Instalar
Visão geral
O app Amazon S3 permite que você salve os backups do Opa! Suite num bucket da sua conta na AWS (Amazon Web Services). Assim, as cópias de segurança ficam fora do servidor e podem ser restauradas se algo acontecer com ele.
O app é gratuito no Opa! Suite. O armazenamento no S3 é cobrado pela AWS, conforme o seu plano.
Pré-requisitos
- Permissão para visualizar o Opa! Store e a permissão Backup no seu grupo de permissões.
- Conta na AWS com um bucket S3 criado para os backups.
- Chave de acesso e chave de acesso secreta de um usuário da AWS (IAM) com permissão no bucket. O Opa! Suite precisa, no mínimo, listar, ler, gravar e excluir objetos do bucket (documentação do rclone, ferramenta usada pelo Opa! Suite).
Passo a passo
Criar a chave de acesso na AWS
- Entre no console do IAM da AWS com o usuário que vai usar o backup.
- No canto superior direito, clique no seu nome de usuário e escolha Credenciais de segurança.
- Em Chaves de acesso, clique em Criar chave de acesso. Se o usuário já tem duas chaves, exclua uma antes.
- Escolha o caso de uso Outro e clique em Avançar.
- Clique em Exibir para ver a chave de acesso secreta, ou em Baixar arquivo .csv. Esta é a única vez em que a AWS mostra a chave secreta. Salve-a em local seguro e clique em Concluído.
As telas da AWS podem mudar. Em caso de dúvida, consulte a documentação da AWS.
Instalar o app no Opa! Suite
- Acesse Opa! Store → Amazon S3 e clique em Instalar. A janela Instalar Amazon S3 abre.
- Em Tipo de instalação, deixe Nova.
- Preencha os campos:
- Nome do App: nome para identificar a integração. Use só letras e números, sem espaços (ex.: "BackupS3").
- Chave de acesso: a chave de acesso criada na AWS.
- Chave de acesso secreta: a chave secreta criada na AWS.
- Pasta para salvar arquivos: o nome do bucket. Para salvar numa subpasta, use
nome-do-bucket/subpasta.
- Clique em Instalar.
Para reconectar o app numa instalação nova, em Tipo de instalação escolha Restaurar arquivo de configuração e envie o arquivo. Veja Restaurar um backup do Opa! Suite.
Resultado esperado
O app aparece como Instalado e o botão Acessar abre a lista de integrações do Amazon S3, com o Nome e a Pasta para salvar arquivos. Nessa lista, o botão Instalar novo permite conectar outro bucket.
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. Testar App confere a conexão e mostra 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 |
|---|---|
| Chave de acesso | Chave de acesso da AWS. |
| Chave de acesso secreta | 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 bucket. Em branco, nada é apagado. |
| Pasta para salvar arquivos | O bucket (e a subpasta, se houver) 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. |
| Testar App mostra Erro ao verificar o app | Confira a chave de acesso, a chave secreta, o nome do bucket e as permissões do usuário da AWS. Veja Erros frequentes em integrações de backup. |
| Não consigo desinstalar o app | Existe uma rotina automática usando esta integração. Exclua a rotina antes. |
Boas práticas
- Crie um usuário da AWS só para o backup, com permissão apenas no bucket usado.
- Preencha o Período que arquivos de backup devem ser mantidos para o bucket não crescer sem controle.
- Guarde o arquivo de configuração fora do servidor.
- Agende os backups fora do horário de atendimento.