

Este guia fornece documentação para o Wickr Enterprise. Se você estiver usando o AWS Wickr, consulte o Guia de [Administração do AWS Wickr ou o Guia](https://docs.aws.amazon.com/wickr/latest/adminguide/what-is-wickr.html) do Usuário do [AWS Wickr.](https://docs.aws.amazon.com/wickr/latest/userguide/what-is-wickr.html)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurações do banco de dados
<a name="database-settings"></a>

O Wickr Enterprise requer um banco de dados MySQL 8.0. Se você estiver usando o MySQL 5.7, consulte [Atualize para o MySQL 8.0](#upgrade-database) para atualizar. Recomendamos usar um banco de dados externo ao seu cluster Kubernetes, como o Amazon RDS, mas você também tem a opção de implantar um banco de dados MySQL **interno** dentro do cluster Kubernetes como parte da instalação.

## Configurações do banco de dados externo
<a name="external-database-settings"></a>
+ **Nome do host: nome** do host ou endereço IP do servidor do banco de dados.
+ **Nome do host do leitor**: nome do host ou endereço IP de um endpoint somente para leitura do servidor de banco de dados (se disponível).
+ **Porta**: A porta na qual o MySQL será acessado.
+ **Nome do banco** de dados: O nome do banco de dados criado no servidor.
+ **Nome de usuário**: O usuário que tem permissões para acessar o banco de dados.
+ **Senha**: A senha desse usuário.
+ **Certificado CA**: um certificado PEM para conexão com o banco de dados via TLS.

**nota**  
Certifique-se de que sua instalação do MySQL esteja usando o conjunto de caracteres latin1 padrão com o agrupamento latin1\$1swedish\$1ci. Isso pode ser feito verificando se seu servidor MySQL foi iniciado com os seguintes sinalizadores:  
`"--character-set-server latin1", "--collation-server latin1_swedish_ci"`

## Configurações internas do banco de dados
<a name="internal-database-settings"></a>

O tipo de banco de dados interno implantará dois StatefulSets em seu cluster para um MySQL primário e secundário com replicação binária. O secundário não recebe nenhum tráfego e está disponível somente para recuperação de desastres e backups.

**Tamanho de armazenamento**: tamanho (em gibibytes) dos volumes persistentes dos pods do banco de dados.

**Aumentando o tamanho do armazenamento do MySQL**

**nota**  
O tipo de volume do seu StorageClass deve suportar a expansão do volume para aumentar o tamanho do armazenamento. Para obter mais informações, consulte [Expansão de volume](https://kubernetes.io/docs/concepts/storage/storage-classes/#allow-volume-expansion).

Os serviços MySQL usados no Wickr Enterprise são implantados como StatefulSet recursos no Kubernetes. StatefulSets torne imutáveis muitas propriedades do recurso, incluindo os modelos de Declaração de Volume Persistente. Como solução alternativa para a imutabilidade do StatefulSets, as seguintes ações devem ser executadas para aumentar o tamanho dos volumes usados pelo MySQL.

1. Edite as declarações de volume persistentes para `data-mysql-primary-0` `data-mysql-secondary-0` e.

   1. `kubectl -n wickr edit pvc data-mysql-primary-0. Set spec.resources.requests.storage`até o tamanho de armazenamento desejado.

   1. `kubectl -n wickr edit pvc data-mysql-secondary-0. Set spec.resources.requests.storage`até o tamanho de armazenamento desejado.

1. Exclua o existente StatefulSets, mas saia dos pods passando a `--cascade=orphan` bandeira.

   `kubectl -n wickr delete statefulset --cascade=orphan mysql-primary mysql-secondary`.

1. Na interface do usuário do KOTS, atualize a configuração do tamanho do armazenamento para corresponder ao valor definido na Etapa 1. Salve e implante essa configuração.

1. Reinicie o StatefulSets para expandir os volumes e colocar os serviços MySQL novamente on-line.

   `kubectl -n wickr rollout restart statefulset mysql-primary mysql-secondary`.

## Atualize para o MySQL 8.0
<a name="upgrade-database"></a>

**Banco de dados externo (RDS)**

Para colocar o Wickr Backend offline, conclua as etapas a seguir.

1. Encontre o namespace da entrada `kubectl get deployments --all-namespaces`

   No exemplo abaixo, o namespace é Wickr e as réplicas são 3.

   ```
   NAMESPACE     NAME                       READY   UP-TO-DATE   AVAILABLE   AGE
   ...
   wickr         ingress-nginx-controller   3/3     3            3           43h
   ...
   ```

1. Diminuir a entrada `kubectl scale deployment/ingress-nginx-controller --replicas=0 -n wickr`

1. Faça um snapshot para fazer backup do banco de dados. Para obter mais informações, consulte [Gerenciamento de backups manuais](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ManagingManualBackups.html) no Guia do *usuário do Amazon Relational Database Service*.

1. Atualize a versão do mecanismo para o MySQL 8.0.x (o MySQL 8.4 não é suportado). Para obter mais informações, consulte [Atualizar uma versão do mecanismo de instância](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Upgrading.html) de banco de dados no Guia do usuário do *Amazon Relational Database Service*.

Para colocar o Wickr Backend on-line, reduza a entrada `kubectl scale deployment/ingress-nginx-controller --replicas=3 -n wickr`

**Banco de dados interno**

Para obter mais informações, consulte [Backup e restauração do MySQL](https://github.com/aws-samples/sample-packages-for-aws-wickr/blob/main/docs/mysql-backup.md).