# Primeiros passos no Edge Node

## Instalação

1. Gere um personal token para executar as ações.

:::tip
Para gerar o personal token necessário para autenticar seus edge nodes, siga os passos da [documentação de Personal Token](/pt-br/documentacao/produtos/guias/personal-tokens/).
:::

2. Instale o agente **Orchestrator** nos seus dispositivos.
3. Autentique o dispositivo depois da instalação.

Para iniciar o processo de instalação do **Edge Node**, você deve fazer o download do binário de instalação do **Orchestrator** de sua preferência.

Confira a listagem de plataformas compatíveis com o Azion Edge Node e faça o download:

| Sistema Operacional | Arquitetura | Arquivo |
| :--- | :---: | --- |
| FreeBSD | x86_64 | [edge-orchestrator](https://downloads.azion.com/freebsd/x86_64/edge-orchestrator) |
| FreeBSD | ARM64 | [edge-orchestrator](https://downloads.azion.com/freebsd/arm64/edge-orchestrator) |
| Linux | x86_32 | [edge-orchestrator](https://downloads.azion.com/linux/x86_32/edge-orchestrator) |
| Linux | x86_64 | [edge-orchestrator](https://downloads.azion.com/linux/x86_64/edge-orchestrator) |
| Linux | ARM32 | [edge-orchestrator](https://downloads.azion.com/linux/arm32/edge-orchestrator) |
| Linux | ARM64 | [edge-orchestrator](https://downloads.azion.com/linux/arm64/edge-orchestrator) |
| MacOS | x86_64 | [edge-orchestrator](https://downloads.azion.com/darwin/x86_64/edge-orchestrator) |

Como alternativa, você pode fazer download via linha de comando. No exemplo, o link para download é referente ao agente Linux/x86_64. Caso queira fazer o download de outra versão, basta alterar a URL para o sistema operacional ou a arquitetura desejada:

`curl -O http://downloads.azion.com/linux/x86_64/edge-orchestrator`

:::note
Os comandos executados no agente *edge-orchestrator* devem ser executados com *privilégios de usuário root*.
:::

O usuário root é aquele que tem acesso irrestrito a todos os componentes do sistema, tanto arquivos quanto processos. Caso você não tenha esses privilégios, pode haver falha na instalação ao tentar gerenciar alguns requisitos do sistema operacional que exigem esses privilégios.

Após o download, você deve seguir os passos abaixo, para que seu dispositivo instale o agente do **Orchestrator**:

1. Instale o agente do **Orchestrator**:<br />
   `chmod +x edge-orchestrator`<br />
   `./edge-orchestrator install`
2. Informe o **token** para o agente do Orchestrator.
3. Confirme as etapas seguintes.
4. Inicialize o agente do **Orchestrator** após finalizar a instalação:<br />
   `edge-orchestrator start`<br />
   **Observação**: caso o seu sistema operacional não disponha de um gerenciador de serviços (systemd, por exemplo), você deve executar como foreground: <br/>`edge-orchestrator start --foreground`

:::note 
Os _logs_ de execução do agente do Orchestrator são armazenados em <br />`/var/log/azion/edge-orchestrator.log`
:::

---

## Visualização de seus nodes

Sempre que o código de instalação for executado em algum dispositivo, seguido da autenticação via token, os edge nodes serão listados na sua conta da Azion.

Para visualizar a lista de edge nodes criados para a sua conta, siga os passos abaixo:

1. Acesse o [Azion Console](https://console.azion.com/).
2. No canto superior esquerdo da página, abra o **Products menu**, identificado pelas três linhas horizontais, e selecione a página **Edge Nodes**.

Os itens listados podem ser verificados validando a coluna de HashId, pois ela contém o hash utilizado para a criação e autenticação do edge node.

---

## Autorização

Para começar a orquestração dos seus edge nodes, eles devem ser autorizados. Para autorizá-los, os seguintes passos devem ser executados:

1. Abra a lista de **Edge Nodes** no [Azion Console](https://console.azion.com/).
2. Clique no ícone em formato de chave e aceite a janela de confirmação.

Após a autorização, o Edge Node pode demorar até *10 segundos* para que a orquestração dos serviços seja iniciada.

Você também pode autorizar todos os seus edge nodes que desejar de uma única vez. Para fazer uso dessa opção, siga os passos abaixo:

1. Abra a lista de **Edge Nodes** no [Azion Console](https://console.azion.com/).
2. Selecione os itens que você quer autorizar ou, se preferir, selecione todos os ícones clicando na primeira caixa de seleção à esquerda.
3. No canto superior direito, clique no botão **Actions** e selecione **Authorize**.
4. Uma mensagem confirmando a sua ação será mostrada.
5. Clique no botão **Confirm** para salvar sua seleção.
6. Você verá uma mensagem de confirmação.

---

## Serviços

Para provisionar os serviços cadastrados na sua biblioteca, siga os passos abaixo:

1. Abra a lista de **Edge Nodes** no [Azion Console](https://console.azion.com/).
2. Selecione o edge node que deseja configurar.
3. Acesse a aba **Services** e clicar no botão **+ Service**.
4. Vincule o serviço desejado e, caso necessário, configure as variáveis necessárias para a sua execução.


Os serviços disponíveis para orquestração via Edge Node devem estar cadastrados em **Edge Libraries** > **Edge Services** e marcados como ativos.

Após a provisão do serviço, o Edge Node inicia a orquestração seguindo a prioridade dos recursos. Você pode acompanhar o processo de instalação dos serviços via logs no agente do Orchestrator.

:::note
Os logs de instalação do serviço são armazenados em <br/>`/var/log/azion/edge-services.log`
:::