Este tutorial vai te ensinar como instalar o AlgoSearch usando o docker compose e como usá-lo localmente na sandbox-net da Algorand, assim como conectá-la a um nó de arquivamento externo (se você tiver um).
Também há um vídeo de passo a passo
Quando um desenvolvedor usa sandbox-nvideo walk-throughet em sua sandbox privada, as transações não foram, até este momento, disponibilizadas no TestNet Explorers para visualização. Isto resulta na necessidade de executar comandos de objetivo para consulta. Este tutorial mostrará como usar o sandbox e ter um explorador em modo rede privada.
CONTEÚDO DEPRECIADO: Mude para DappFlow
Este conteúdo é depreciado.
Se você precisar de um explorador de blocos para a sandbox-net da Algorand , DappFlow é a opção recomendada.
Golang
Python JavaScript Golang Swift C/C++ C# cURL goal Java TEAL
Requisitos
Este tutorial serve para usuários Windows, Linux e Mac.
É essencial que você:
tenha o Docker instalado em sua máquina.
tenha o Sandbox da Algorand instalado e funcionando em sua máquina.
tenha o Git instalado e funcionando em sua máquina local.
É opcional que você tenha instalado o Make, a maneira mais fácil de fazer isso para o Windows é ter Chocolatey instalado e usar o comando: choco install make na linha de comando. Outras instruções do OS sobre a instalação do Make podem ser encontradas aqui.
Contexto
O AlgoSearch é um explorador de blockchain que pode ser implantado localmente e conectado a uma rede Algorand local hospedada no Sandbox, por exemplo, permitindo que você examine as transações de teste que fez na sandbox-net, e também pode ser conectado a redes hospedadas remotamente, tais como seu próprio nó de arquivamento, para que você possa visualizar as transações ali listadas.
O AlgoSearch também foi implantado aqui para mainnet, testnet e betanet.
Passos
- Instalando o AlgoSearch
- Configurando AlgoSearch para a Sandbox-net
- Executando AlgoSearch Com Sandbox-net
- Outros Comandos
- Executando AlgoSearch Com Nó de Arquivamento Externo
1. Instalando AlgoSearch
Crie um diretório em sua máquina local para clonar o repositório.
Clone o repositório em seu diretório pretendido, navegando para o diretório em sua linha de comando e executando o clone do git https://github.com/kevguy/algosearch.git
Se você tiver quaisquer instâncias do CouchDB funcionando, feche-as (elas podem entrar em conflito com a instância do CouchDB que será criada pela Docker Compose).
Parabéns. Agora você tem o AlgoSearch instalado!
2.Configurando o AlgoSearch para a Sandbox-net
Para executar o AlgoSearch com a sandbox-net você precisará substituir o arquivo docker-compose.yml em seu repositório Sandbox local por nossa versão encontrada no diretório algosearch/sandbox_files de seu repositório AlgoSearch ou baixado separadamente aqui. Neste arquivo, adicionamos uma nova rede chamada "sandbox-shared-network" e o host e a rede para cada serviço para que possam ser acessados por outra rede Docker compose (ou seja, por AlgoSearch).
Após esta mudança ter sido feita gire a Sandbox, como de costume, no git bash, com o comando:
./sandbox up -v
Isto vai permitir que você teste se o sandbox ainda está funcionando.
Em seguida, vá até seu repositório AlgoSearch local e execute docker network ls na sua linha de comando e você deve ver uma tabela que inclui uma rede com o nome "sandbox_sandbox-shared-network". Isto mostra que podemos fazer a ponte entre todos os containers que temos no Docker do AlgoSearch e a rede do sandbox.
3. Executando AlgoSearch Com Sandbox-net
No repositório AlgoSearch se você tem a Make instalada, execute o comando make up para começar a criar as imagens do Docker. Se o Make não estiver instalado, então use o seguinte comando docker-compose -f zarf/compose/compose.yaml -f zarf/compose/compose-config.yaml up --detach --remove-orphanspara fazer a mesma coisa.
Espere um minuto porque demorará um pouco mais do que o feedback da linha de comando sugere para que o CouchDB seja configurado.
Para verificar se o CouchDB está configurado:
vá para
localhost:5984/_utils/#logine
faça login com o nome do usuário “algorand” e a senha “algorand”
verifique o Database Name, deve ter 2 “_users” e “algo_global”, “algo_global” deve ter pelo menos 5 # de Docs. Uma vez que você tenha terminado de configurar o AlgoSearch e começado a usá-lo, você pode voltar a ele para rever os dados armazenados no backend (se quiser).
Para se certificar de que o AlgoSearch está funcionando, vá para localhost:3000 no seu navegador, e você deve ver algo como a imagem do início deste tutorial. Você notará que ainda não há transações (na coluna à esquerda), portanto, você terá que fazer uma.
Volte para o terminal bash em que você está executando o sandbox e você verá que o sandbox lhe deu um exemplo de uma transação que você pode enviar e que se parece com:
./sandbox goal clerk send -a 123456789 -f [account 1] -t [account 2]
execute esse comando para enviar a transação
Aguarde a sincronização dos blocos na sandbox-net com os blocos no CouchDB. Quando isso for feito, você verá a transação aparecer no painel AlgoSearch (uma transação aparecerá na coluna da esquerda).
Parabéns, o AlgoSearch agora está funcionando com o Sandbox!
Nota: Você pode receber este erro em um Mac executando o Mac OS Monterery da seguinte forma:
Ports are not available: listen tcp 0.0.0.0:5000: bind: address already in use
O processo em execução nesta porta acaba sendo um servidor* AirPlay*. Eliminá-lo não servirá de nada e ele apenas se reinicializará automaticamente pelo sistema. Você pode desativá-lo da seguinte forma:
System Preferences › Sharing , and unchecking AirPlay Receiver to release port 5000.
4. Outros Comandos
Para parar de executar o AlgoSearch, navegue até seu repositório na linha de comando e dê o comando make down, ou, se você não tiver instalado, Make docker-compose -f zarf/compose/compose.yaml down --remove-orphans.
Para obter os logs execute make logs, ou se você não tiver instalado o Make, execute docker-compose -f zarf/compose/compose.yaml logs -f
5. Executando a AlgoSearch Com Nó de Arquivamento Externo
Os passos para conseguir isso são todos iguais, exceto as configurações do repositório AlgoSearch em compose-config.yaml que são ligeiramente diferentes. Você precisa alterar apenas essas variáveis (deixe as outras como estão):
services:
algosearch-backend:
...
ALGOSEARCH_COUCH_DB_INIT: "false"
ALGOSEARCH_COUCH_DB_MIGRATE: "false"
ALGOSEARCH_COUCH_DB_HOST: [ip address]:5984
ALGOSEARCH_ALGOD_PROTOCOL: "[http OR https]"
ALGOSEARCH_ALGOD_ADDR: "[ip address]:4001"
ALGOSEARCH_ALGOD_TOKEN: "[something]"
...
algosearch-frontend:
ALGOSEARCH_ALGOD_PROTOCOL: "[http OR https]"
ALGOSEARCH_ALGOD_ADDR: "[ip address]:4001"
ALGOSEARCH_ALGOD_TOKEN: "[something]"
Este artigo foi escrito por Thomas Upfield, traduzido por Fátima Lima e seu original pode ser lido aqui.
05 de maio de 2022
Latest comments (0)