Melhores Práticas de Implantação

Um resumo condensado das 25 práticas de implantação mais importantes extraídas de todas as páginas desta seção.

Marcar commits de lançamento: Cada implantação mapeia para uma tag git imutável (Implantando Programas).
Testar âncora antes da implantação: Matriz completa verde na tag RC.
solana-verify em CI: Bloquear lançamento em caso de incompatibilidade de hash (Builds Verificáveis).
Arquivar todos os .so: Retenção em releases/<version>/ para rollback.
Simular custo de implantação: solana program deploy --dry-run no cluster de destino.
Verificação de sanidade do cluster: solana config get antes da implantação via CLI.
Sincronizar ID do programa: anchor keys sync corresponde a declare_id!.
Ensaio em Devnet: Mesma pipeline em devnet antes de mainnet.
Publicar atestado de hash: README + documento de auditoria com {program_id, hash, commit}.
Verificar hash pós-implantação: get-program-hash igual ao artefato de CI.
Multisig antes de TVL: Transferir autoridade de upgrade para Squads (Governança).
Sem autoridade de hot wallet em mainnet: O implantador transfere a autoridade imediatamente após a implantação.
Modelo de proposta: Hash, testes, riscos, plano de rollback exigidos para upgrades.
Timelock na governança: 24-72h para reação da comunidade em upgrades.
Imutável apenas deliberadamente: --final após teste e auditoria (Imutável).
Simulação de rollback trimestral: Exercício de implantação ruim em Devnet e reversão.
Runbook de incidentes: Dump, rollback, verificar, comunicar (Rollbacks).
Fechar buffers obsoletos: Reclamar aluguel após a implantação.
Fixar toolchain Agave 4.1.1: Build corresponde ao validador BPF loader.
Documentar autoridade de upgrade: program show público da autoridade corresponde à documentação.
Sem edições de configuração em scripts de implantação: Manter chaves no gerenciador de segredos.
Pares de chaves devnet/mainnet separados: Evitar erro de digitação no cluster errado.
Monitorar slots de upgrade: Alerta sobre alterações inesperadas nos dados do programa.
Plano de migração de estado: Layouts que quebram enviam ix de migração, não upgrade cego.
Escopo de diff de auditoria: Fornecer intervalo de commits desde a última tag auditada para upgrades.

FAQs

Checklist mínimo para mainnet?

Testes aprovados, verificação de hash, teste rápido em devnet, autoridade multisig, verificação de hash pós-implantação, atestado público.

Quando revogar a autoridade?

Após teste estendido, auditorias e voto de governança - não no primeiro dia.

Erro de implantação mais comum?

Implantar artefato não verificado com autoridade de upgrade de hot wallet em TVL de produção.

Relacionados

Noções Básicas de Implantação - entrada da seção
Upgrades de Programa - fluxo de upgrade
Melhores Práticas de Segurança - código seguro
Melhores Práticas de Teste - testes pré-implantação

Versões da Stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, e LiteSVM 0.6.x.

Melhores Práticas de Implantação

Um resumo condensado das 25 práticas de implantação mais importantes extraídas de todas as páginas desta seção.

Marcar commits de lançamento: Cada implantação mapeia para uma tag git imutável (Implantando Programas).

Testar âncora antes da implantação: Matriz completa verde na tag RC.

solana-verify em CI: Bloquear lançamento em caso de incompatibilidade de hash (Builds Verificáveis).

Arquivar todos os .so: Retenção em releases/<version>/ para rollback.

Simular custo de implantação: solana program deploy --dry-run no cluster de destino.

Verificação de sanidade do cluster: solana config get antes da implantação via CLI.

Sincronizar ID do programa: anchor keys sync corresponde a declare_id!.

Ensaio em Devnet: Mesma pipeline em devnet antes de mainnet.

Publicar atestado de hash: README + documento de auditoria com {program_id, hash, commit}.

Verificar hash pós-implantação: get-program-hash igual ao artefato de CI.

Multisig antes de TVL: Transferir autoridade de upgrade para Squads (Governança).

Sem autoridade de hot wallet em mainnet: O implantador transfere a autoridade imediatamente após a implantação.

Modelo de proposta: Hash, testes, riscos, plano de rollback exigidos para upgrades.

Timelock na governança: 24-72h para reação da comunidade em upgrades.

Imutável apenas deliberadamente: --final após teste e auditoria (Imutável).

Simulação de rollback trimestral: Exercício de implantação ruim em Devnet e reversão.

Runbook de incidentes: Dump, rollback, verificar, comunicar (Rollbacks).

Fechar buffers obsoletos: Reclamar aluguel após a implantação.

Fixar toolchain Agave 4.1.1: Build corresponde ao validador BPF loader.

Documentar autoridade de upgrade: program show público da autoridade corresponde à documentação.

Sem edições de configuração em scripts de implantação: Manter chaves no gerenciador de segredos.

Pares de chaves devnet/mainnet separados: Evitar erro de digitação no cluster errado.

Monitorar slots de upgrade: Alerta sobre alterações inesperadas nos dados do programa.

Plano de migração de estado: Layouts que quebram enviam ix de migração, não upgrade cego.

Escopo de diff de auditoria: Fornecer intervalo de commits desde a última tag auditada para upgrades.

FAQs

Checklist mínimo para mainnet?

Testes aprovados, verificação de hash, teste rápido em devnet, autoridade multisig, verificação de hash pós-implantação, atestado público.

Quando revogar a autoridade?

Após teste estendido, auditorias e voto de governança - não no primeiro dia.

Erro de implantação mais comum?

Implantar artefato não verificado com autoridade de upgrade de hot wallet em TVL de produção.

Relacionados

Versões da Stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, e LiteSVM 0.6.x.

Melhores Práticas de Implantação

FAQs

Relacionados

Buscar na documentação

Melhores Práticas de Implantação

FAQs

Relacionados