Compile uma aplicação React a partir do repositório existente, sirva os arquivos gerados ou o processo Node.js de produção e conecte a versão a uma rota HTTPS estável.
Um projeto React que funciona ainda precisa de uma implantação segura.
A aplicação ou o serviço é apenas uma parte da produção. As evidências de compilação, o estado do ambiente de execução, a saúde, os segredos, os logs, as rotas e a versão promovida devem poder ser examinados em conjunto.
Mantenha a compilação React que você já usa
Use a compilação npm e o lockfile atuais do projeto. Sirva uma aplicação do cliente a partir do seu diretório de saída ou mantenha o comando Node.js explícito exigido por um framework React com renderização no servidor.
Promova a versão que informa estar saudável
Verifique a rota raiz e o fallback do cliente antes de promover a versão. Aplicações renderizadas no servidor devem expor um endpoint de saúde leve na porta de execução.
Rastreie a produção até o código-fonte
Os resultados da compilação, os logs de execução, o estado de saúde, os segredos, os domínios e a versão promovida permanecem vinculados ao projeto, em vez de separados entre ferramentas sem relação entre si.
Do código-fonte à versão publicada
Três etapas mantêm o caminho de implantação fácil de revisar.
Use o código-fonte e o comportamento de produção que o projeto já tem. O manifesto registra o que a plataforma deve compilar ou provisionar e como verificar se o resultado está pronto.
01
Começar com código-fonte ou um modelo
Traga o repositório existente ou examine e implante uma das variantes específicas de projeto inicial vinculadas abaixo.
$adios login
02
Revisar o contrato de implantação
Mantenha os comandos, a versão do ambiente de execução ou do serviço, o comportamento das verificações de saúde e as referências a segredos em adios.yaml.
$git diff -- adios.yaml
03
Implantar e inspecionar o resultado
Acompanhe as evidências de compilação e execução, verifique a versão candidata e abra a rota promovida ou a conexão do serviço.
$adios up
adios.yaml
Seu projeto
name: react-app
build_cmd: npm ci && npm run build
start_cmd: npm start
runtime:
name: node@24
port: 3000
health_path: /
Configure npm start para servir a compilação de produção. Um projeto exclusivamente estático pode começar pelo modelo estático Nginx.
Pontos de partida prontos para implantação
Comece React a partir de um modelo quando o repositório ainda não estiver pronto.
Use o projeto inicial estático Nginx para uma compilação exclusiva do cliente ou examine o projeto inicial Next.js com TypeScript quando a aplicação React precisar de um ambiente de execução no servidor.
Aplicativos web
Nginx Static
Um projeto inicial de Nginx para HTML, CSS, JavaScript estáticos e aplicativos de página única.
HTMLNenhum
Chave do modelo
nginx:static
Ambiente de execução
nginx
Repositório
template-nginx-static
Origem do código-fonte
.
git clone https://github.com/adiosdotdev/template-nginx-static.git
cd template-nginx-static
adios up
Verifique a carga de trabalho.Depois, promova a versão.
O caminho mais seguro para a primeira implantação começa com uma compilação ou configuração de serviço reproduzível e uma prévia que teste as dependências que serão realmente usadas em produção.
Pronto quando…
npm run build succeeds from the committed lockfile.
O comando de produção serve a saída compilada.
As rotas do cliente retornam o shell da aplicação como fallback quando necessário.
As variáveis de ambiente públicas e privadas são separadas.
Use uma prévia quando…
O projeto usa renderização no servidor ou rotas de API.
As URLs dos recursos dependem do caminho base ou do nome de host final.
A configuração do ambiente de execução está atualmente incluída no bundle do cliente.
Respostas às suas perguntas
O que saber antes de implantar React.
Revise os limites do ambiente de execução ou do serviço, o caminho do modelo, o comportamento em caso de falha e as verificações de produção antes de criar a primeira versão.
Adios pode implantar um projeto React existente?
Sim. Execute a CLI Adios na raiz do projeto, mantenha o repositório e os arquivos de dependências que você já usa e adicione um arquivo adios.yaml que descreva a compilação de produção, o comando de inicialização, a porta e o caminho de saúde.
Preciso de Docker para implantar React?
Não para um ambiente de execução padrão compatível. Use os comandos de produção habituais do projeto em adios.yaml. Se a compilação precisar de pacotes incomuns do sistema operacional ou bibliotecas nativas, verifique essas dependências em uma prévia antes de promover a versão.
Adios pode implantar uma aplicação React com Vite?
Sim. Compile o projeto Vite e sirva a saída com um servidor estático de produção. Confirme o diretório de saída e o comportamento do fallback SPA antes de promover a versão.
E se minha aplicação React usar renderização no servidor?
Use o servidor de produção do framework e declare seu comando de inicialização, sua porta e seu caminho de saúde. A página de implantação Next.js cobre o caminho específico mais comum desse framework.
O que acontece quando a compilação ou a verificação de saúde falha?
A versão candidata mantém os resultados de compilação e execução disponíveis para análise. Ela deve informar estar saudável antes de se tornar a versão promovida que atende a rota da aplicação.
Posso começar por um modelo em vez de um repositório existente?
Sim. Esta página inclui links para os projetos iniciais oficiais Adios React mais próximos do seu caso. Examine a variante exata do código-fonte, implante-a no console ou clone-a localmente e execute adios up.