O que é Ambiente local?

O conjunto usado durante o desenvolvimento

Ambiente local é o conjunto de código, ferramentas, dependências e serviços que você utiliza na sua máquina para desenvolver uma aplicação. Ele pode incluir runtime, banco, servidor de desenvolvimento e arquivos de configuração. A composição depende do projeto.

Alguns componentes podem executar em containers, e outros podem ser acessados remotamente. Nesse caso, a experiência de desenvolvimento combina recursos locais e externos. A existência de uma página aberta em localhost não comprova que todas as operações ficam no computador.

Antes de testar um cadastro, confira quais serviços a aplicação utiliza. Um formulário local pode enviar uma chamada para uma API real se estiver configurado com esse destino. Separar ambientes também exige conferir endereços e credenciais.

Iniciar o projeto conforme sua configuração

npm run dev

Esse comando executa o script dev definido no package.json do projeto. Confira o conteúdo desse script para identificar a ferramenta iniciada e siga a documentação de instalação, configuração e serviços auxiliares. O nome dev, sozinho, não informa se o comando inicia apenas a interface ou também outros processos.

Um servidor de desenvolvimento pode observar arquivos e atualizar a página após alterações, conforme a ferramenta utilizada. Quando você muda uma configuração que só é lida na inicialização, pode precisar reiniciar o processo para conferir seu efeito. Compare o comportamento observado com a forma de atualização documentada para aquele arquivo.

Localhost no navegador e no container

localhost representa o próprio ambiente de rede do processo que o utiliza. No navegador do computador, costuma apontar para esse computador. Dentro de um container, normalmente aponta para o próprio container, e não automaticamente para o host.

Por isso, um endereço que funciona no navegador pode falhar quando usado pelo backend em container. Confira a rede, o nome do serviço e a publicação de portas. A documentação da ferramenta define a forma de comunicação entre esses ambientes.

Aproximar o desenvolvimento do destino

Versões de runtime, extensões e bibliotecas podem mudar o comportamento. Um arquivo de lock e a declaração das versões ajudam a reproduzir a instalação. Serviços externos também precisam ter configurações compatíveis com os testes pretendidos.

Diferenças de sistema operacional podem afetar caminhos, permissões e distinção entre maiúsculas e minúsculas nos nomes de arquivos. Uma importação que funciona em um computador pode falhar em outro. O build e os testes devem contemplar o ambiente de publicação quando isso for relevante.

Como conferir o ambiente

Siga os comandos documentados a partir do diretório correto. Verifique versões, parâmetros obrigatórios e serviços em execução, usando valores fictícios nos testes. Quando houver falha, compare o ambiente efetivo com o esperado pelo projeto.

O verbete de configuração explica como os endereços e limites utilizados pela aplicação podem variar entre os ambientes.

Aplicação na formação

Developer Workspace

O ambiente local reúne as ferramentas e os serviços utilizados para desenvolver e testar o projeto.

Conhecer a formação →