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 configurados na pasta da Build.

Os Tokens são únicos por desenvolvedor, e cada pessoa deve ter 2 tokens:

• 1 para usar no ambiente de Staging
• outro para usar no ambiente de CDN/Production

Você só precisa gerar estes Tokens uma única vez, por ambiente. Como o token ficará associado ao e-mail do desenvolvedor, o mesmo Token terá autorização em múltiplos projetos, lojas e templates, desde que o desenvolvedor um usuário com perfil de Desenvolvedor na loja que vai atuar.

Gerar seus Tokens de Desenvolvedor

Gerencie você mesmo os acessos

Garanta que a sua agência ou o seu time 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.

Um usuário com o perfil de Gestor pode criar outros usuários com outros perfis, permitindo que o time se auto gerencie dentre todos os projetos.

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 recebimento de um Token. É importante verificar se o e-mail não caiu na caixa de spam
6. Dentro da pasta da Build, na raiz, 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:
   • Loja ainda não lançada (em desenvolvimento): nomedaloja.cdn.vnda.com.br/admin/entrar
   • 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 recebimento de um Token. É importante verificar se o e-mail não caiu na caixa de spam
6. Dentro da pasta da Build, na raiz, 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 da Build

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 independente 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 colocá-las 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:

.env

STGTOKEN=
PRODTOKEN=
AGENT=