Se você quer começar rapidamente a utilizar o Eitri, este guia é para você. Aqui você encontrará os principais comandos e instruções para começar a desenvolver rapidamente usando o Eitri.
Requisitos para desenvolver com Eitri¶
Você precisará do seguinte para desenvolver usando o Eitri:
- Instalar o Node (versão 18 ou superior), o NPM e Git em seu computador
- Instalar a nossa ferramenta de linha de comando usando o comando
npm install -g eitri-cli - Fazer o login como desenvolvedor com sua conta digitando
eitri loginno terminal e seguindo os passos propostos
Criando seu primeiro Eitri-App¶
Agora que você tem sua conta no Eitri configurada e a CLI instalada, é hora de criar seu primeiro projeto. Vamos começar:
- Na pasta onde deseja criar seu projeto utilize o seguinte comando:
eitri app create <nome_do_projeto>(Você precisará de permissão como org admin para criar novos apps) - Você precisará selecionar um template para usar como base para seu app. Atualmente Eitri suporta apps Vtex, Wake e Shopify.
- Ao confirmar, será criada uma pasta com o seu projeto. Você pode acessa-la e utilizar o comando
eitri app startpara iniciar o desenvolvimento - Quando estiver tudo pronto, você receberá um QrCode que deve ser escaneado com o Eitri Play
- As versões de seus Eitri-apps (módulos) podem ser geradas individualmente usando
eitri push-versiondentro da pasta de cada um deles - Após gerar a primeira versão de um Eitri-app é possível publica-las nos ambientes de seu app.
Warn
Para gerar uma versão de um Eitri-app é preciso que as dependencias dele já existam no sistema. Se você tem um eitri-app que depende de outro (como um shared por exemplo), garanta primeiro que a versão do shared foi gerada para satisfazer a dependencia.
Info
Os projetos de Apps Eitri já vem com sugestões de implementação de CI para automatizar o processo de geração de versão e até publicação nos ambientes mas você pode personaliza-las conforme necessário.
Administrando Eitri-Apps¶
Para gerenciar a versão publicada, efetuar o rollback para versões anteriores e administrar as permissões de seu Eitri-App, você pode acessar o painel de admin do Eitri, logando com sua conta de desenvolvedor: