> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Executando MySQL no Kubernetes

> O que é preciso para executar o MySQL no Kubernetes: StatefulSets versus operators, decisões de armazenamento e uma análise honesta de quando um banco de dados gerenciado é a melhor resposta.

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

O Kubernetes foi construído para cargas de trabalho sem estado, e o MySQL é o oposto disso. Executá-lo lá é totalmente possível e amplamente feito; só significa que o Kubernetes não dá de graça nenhuma das partes difíceis do banco de dados. Este guia cobre os três níveis de comprometimento, as decisões de armazenamento que importam e os casos em que você não deveria fazer isso de jeito nenhum.

## Três Caminhos de Entrada

**Um StatefulSet de instância única.** Um pod MySQL com um PersistentVolumeClaim. Este é o formato certo para ambientes de desenvolvimento, CI e ferramentas internas em que alguns minutos de indisponibilidade na falha de um nó são aceitáveis. É aproximadamente o equivalente no Kubernetes de um contêiner Docker com um volume, e o [guia de Docker](https://villagesql.com/docs/pt-BR/guides/mysql-on-docker.md) cobre a configuração do lado do MySQL que se aplica igualmente aqui.

Os pontos essenciais que confundem as pessoas, como aparecem no manifesto:

```yaml theme={null}
apiVersion: apps/v1
kind: StatefulSet
spec:
  replicas: 1            # one writer; MySQL doesn't scale writes by replica count
  volumeClaimTemplates:  # storage that survives the pod
    - metadata:
        name: data
      spec:
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 50Gi
```

Defina a requisição e o limite de memória do pod com o mesmo valor, e dimensione `innodb_buffer_pool_size` dentro dele (50 a 70 por cento do limite). Um pod MySQL que ultrapassa seu limite de memória é morto por OOM no meio de uma escrita; o mesmo modo de falha do Docker, a mesma correção.

**Um operator.** Para qualquer coisa com formato de produção, use um operator em vez de StatefulSets feitos à mão: o MySQL Operator da Oracle, o da Percona, ou o Vitess para escala com sharding. Os operators codificam os runbooks — provisionar réplicas, orquestrar failover, coordenar backups — como controllers. O custo é uma nova dependência com sua própria cadência de atualização e seus próprios modos de falha, que você precisa entender antes de um incidente, não durante.

**Um banco de dados gerenciado ao lado do cluster.** Execute a aplicação no Kubernetes e aponte-a para o RDS, o Cloud SQL ou outro MySQL gerenciado. Esta é a resposta padrão para equipes pequenas: outra pessoa cuida dos backups, do failover e das atualizações, e seu cluster permanece sem estado.

## O Armazenamento É a Decisão Que Importa

* **Sempre um PVC, nunca `emptyDir`.** Um volume `emptyDir` morre com o pod, e pods MySQL são reagendados por motivos que não têm nada a ver com você.
* **Prefira uma storage class baseada em armazenamento de bloco em rede** (EBS, PD e equivalentes). `ReadWriteOnce` é exatamente o que um banco de dados quer; um sistema de arquivos em rede (`ReadWriteMany` no estilo NFS) é exatamente o que ele não quer.
* **NVMe local é mais rápido e mais arriscado.** Volumes locais prendem o pod a um nó; a perda de um nó é uma perda de dados, a menos que a replicação a cubra. Combine armazenamento local apenas com um conjunto de réplicas gerenciado por um operator.
* **Faça benchmark de IOPS antes de se comprometer.** As storage classes padrão nas grandes nuvens costumam ser provisionadas por capacidade, não por IOPS, e um banco de dados que funcionava bem em um laptop se arrasta em um volume subprovisionado.

## Probes Sem Armadilhas

Um liveness probe que executa uma consulta pode matar um servidor saudável que está momentaneamente lento (buffer pool frio, DDL longo), e o Kubernetes reiniciar o MySQL no meio de uma recuperação faz a recuperação demorar mais. Mantenha o liveness mínimo (o processo está aceitando TCP?) e coloque a verificação de saúde real (`mysqladmin ping`, atraso de réplica) no readiness probe, que só afeta o roteamento de tráfego.

## Quando Não Fazer Isso

Evite MySQL no Kubernetes quando o banco de dados é a única fonte de verdade do seu produto, quando a equipe não tem ninguém de plantão que conheça os dois sistemas, ou quando existe uma oferta gerenciada na sua nuvem a um custo aceitável. O cálculo honesto: o Kubernetes adiciona superfície operacional exatamente ao componente em que os erros operacionais são menos recuperáveis.

O VillageSQL roda em qualquer lugar em que o MySQL roda, e a imagem `villagesql/server` é um substituto direto de `mysql` em qualquer um dos manifestos acima: mesmo layout de diretório de dados, mesma porta, mesmos clientes.

## Veja também

* [MySQL no Docker](https://villagesql.com/docs/pt-BR/guides/mysql-on-docker.md) — os fundamentos de contêineres sobre os quais o Kubernetes se apoia
* [Fundamentos de replicação](https://villagesql.com/docs/pt-BR/guides/replication-basics.md) — o que um operator automatiza para você
* [Estratégias de backup](https://villagesql.com/docs/pt-BR/guides/backup-strategies.md) — backups continuam existindo; um snapshot de PVC não é uma política de backup


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.