Pular para o conteúdo principal

🧶 O que é o Yarn?

O Yarn é um gerenciador de pacotes JavaScript criado pelo Facebook como uma alternativa ao NPM, com foco em performance, confiabilidade e segurança. Assim como o NPM, ele permite instalar dependências e rodar scripts de inicialização da aplicação.

atenção

O Yarn não é um gerenciador de processos. Ou seja, ele não mantém sua aplicação rodando em segundo plano, não reinicia automaticamente em caso de falhas e não oferece tolerância a falhas.
Para ambientes de produção, recomenda-se utilizar o PM2 como gerenciador de processos. Para aprender sobre o PM2, clique aqui!

🛠️ Como utilizar o Yarn na SaveinCloud​

Por padrão, o NPM vem configurado para ser utilizado como o gerenciador de pacotes em instâncias Node.js. Para utilizar o Yarn, basta alterar o valor da variável de ambiente PACKAGE_MANAGER para yarn, conforme os passos abaixo.

Variáveis de Ambiente

Variável Package Manager

🚀 Configurando scripts com Yarn​

Assim como com o NPM, o Yarn executa scripts definidos no arquivo package.json. O Yarn busca pelo script start por padrão.

Exemplo:

{
  "scripts": {
    "start": "node ./server.js"
  }
}

Você pode iniciar a aplicação com:

yarn start

📄 Localização do package.json​

O arquivo package.json deve estar localizado no diretório /home/jelastic/ROOT - que é o padrão definido na variável de ambiente $ROOT_DIR, podendo ter o diretório alterado conforme necessidade -, pois é lá que a plataforma executa comandos de instalação de dependências e inicialização da aplicação.

info

Caso o arquivo principal da aplicação não siga os nomes padrões (server.js, index.js, app.js), você pode usar a variável de ambiente $APP_FILE para definir o entrypoint.

📦 Instalação de Dependências com Yarn​

Para que as dependências sejam instaladas automaticamente com o Yarn no início da instância, você pode usar a variável de ambiente:

UPDATE_PACKAGES_ON_RESTART=true

Com isso, a plataforma executará:

yarn install

toda vez que a instância for reiniciada.

atenção

🔒 Certifique-se de liberar no firewall a porta que sua aplicação utiliza para garantir o funcionamento correto. Para aprender sobre Gestão de Firewall, clique aqui!

🧰 Comandos úteis do Yarn​

ComandoDescrição
yarn installInstala todas as dependências listadas no package.json.
yarn add <pacote>Instala e adiciona um pacote específico.
yarn remove <pacote>Remove um pacote do projeto.
yarn startExecuta o script start definido no package.json.
yarn run <script>Executa outro script personalizado.
yarn outdatedLista as dependências desatualizadas.
yarn upgradeAtualiza os pacotes para a versão mais recente permitida.

🧠 Dúvidas?​

Entre em contato com o suporte técnico e envie sua dúvida que estaremos à disposição para te ajudar!