Tokens de Desenvolvedor

Para conseguir executar os comandos do projeto e atualizar os arquivos, cada desenvolvedor vai precisar de um par de chaves, ou Tokens, que devem ser adicionados na pasta do projeto para que os scripts utilizem.

Os Tokens são únicos por desenvolvedor, e cada pessoa deve ter 2 tokens: 1 para usar no ambiente de Staging e outro para usar no ambiente de CDN/Production.

O processo de geração dos Tokens deve ser executado uma única vez em cada ambiente. Como o token ficará associado ao e-mail do desenvolvedor, o mesmo Token terá autorização em múltiplos projetos, desde que o desenvolvedor possua um usuário válido de desenvolvedor na loja.

Gerar seus Tokens de Desenvolvedor

🚧

Garanta que a sua agência já possui um acesso com perfil Gestor, tanto no ambiente de Staging quanto no ambiente de CDN/Produção, para a loja que você pretende trabalhar.

Token para Staging

1. Acessar o Admin com o perfil Gestor já definido. O endereço do admin segue o padrão nomedaloja.vnda.dev/admin/entrar, onde nomedaloja é o nome definido para o projeto

2. No Admin, acessar as Configurações (ícone da engrenagem, no canto inferior esquerdo) e abrir a opção Usuários

3. Na tela de usuários, clicar no botão de Criar Novo Usuário (+)

4. Criar um usuário novo para cada desenvolvedor que trabalhará na loja. IMPORTANTE: garanta que vai definir a Função como Desenvolvedor! Esta função que dá permissão aos tokens de desenvolvedor operarem na loja. Segue exemplo:

5. 

   O desenvolvedor deve verificar o e-mail para o recebimendo de um Token. Importante verificar se o e-mail não caiu na caixa de spam

6. Dentro da pasta da Build, na raíz, criar um arquivo chamado .env, caso ainda não exista

7. Dentro deste arquivo, adicionar o Token recebido por e-mail, no formato STGTOKEN=<hash do token aqui>

Token para CDN/Production

1. Acessar o Admin com o perfil Gestor já definido. Para Production, a URL do admin é diferente, dependendo se a loja já lançou, ou se ainda está em desenvolvimento:
   1. Loja ainda não lançada (em desenvolvimento): nomedaloja.cdn.vnda.com.br/admin/entrar
   2. Loja já lançada: https://www.enderecodosite.com.br/admin/entrar
2. No Admin, acessar as Configurações (ícone da engrenagem, no canto inferior esquerdo) e abrir a opção Usuários
3. Na tela de usuários, clicar no botão de Criar Novo Usuário (+)
4. Criar um usuário novo para cada desenvolvedor que trabalhará na loja. IMPORTANTE: garanta que vai definir a Função como Desenvolvedor! Esta função que dá permissão aos tokens de desenvolvedor operarem na loja
5. O desenvolvedor deve verificar o e-mail para o recebimendo de um Token. Importante verificar se o e-mail não caiu na caixa de spam
6. Dentro da pasta da Build, na raíz, criar um arquivo chamado .env, caso ainda não exista
7. Dentro deste arquivo, adicionar o Token recebido por e-mail, no formato PRODTOKEN=<hash do token aqui>

Código de Agente

Para as agências parceiras, os desenvolvedores precisam adicionar também, no arquivo .env, o código interno da agência parceira. Essa informação é disponibilizada no Discord, no canal da agência. No arquivo, passar o agente como AGENT=nomedoagente

Arquivo .env

O arquivo de variáveis de ambiente, arquivo .env, é essencial para salvar os tokens de forma segura e garantir que os comandos vão conseguir se comunicar com o servidor, para fazer o upload dos arquivos independende do ambiente.

Dentro da Build há um arquivo chamado .env.sample, que pode ser usado como referência na hora de criar o seu arquivo .env. Você pode copiar as informações do arquivo sample e enviar colocar elas dentro do arquivo .env que criou, completando com os tokens e informação de agente.

Caso precise, estas são as variáveis de ambiente que devem existir obrigatoriamente no seu arquivo .env:

STGTOKEN=
PRODTOKEN=
AGENT=