Como rodar o Connector local?

Descompacte o arquivo .zip em uma pasta de sua preferência e execute o seguinte comando, substituindo as chaves da sua API.

COPIAR

CLIENT_ID=encrypted.<Seu client id> \
CLIENT_SECRET='encrypted.<Seu client secret>' \
./guiabolso_connector_client_1.0.0/bin/application

Para evitar problemas com interpretação de caracteres especiais em variáveis de ambiente, é sempre recomendado passar os valores entre aspas simples.

Você deverá ver uma mensagem no final do console parecida com a exibida abaixo, o que significa que a aplicação está executando e pronta para receber requests na porta 9000.

COPIAR

(  _ \(_  _)(  _ \(  _ \(  _  )
 ) __/ _)(_  ) __/ ) __/ )(_)(   http://pippo.ro
(__)  (____)(__)  (__)  (_____)  1.11.0

2020-09-09 19:04:24.651 [main] INFO  ro.pippo.core.PippoFilter {} - Pippo started (PROD)
2020-09-09 19:04:24.668 [main] INFO  o.e.j.server.handler.ContextHandler {} - Started r.p.j.PippoHandler@217c23ce{/,null,AVAILABLE}
2020-09-09 19:04:24.689 [main] INFO  o.e.jetty.server.AbstractConnector {} - Started ServerConnector@1084ac45{HTTP/1.1,[http/1.1]}{0.0.0.0:9000}
2020-09-09 19:04:24.689 [main] INFO  org.eclipse.jetty.server.Server {} - Started @2063ms

Como adicionar o Redis?

Você pode configurar um cache distribuído dentro do cache de nível hierárquico do Connector. Se ele não encontrar os dados dentro do Caffeine ele irá procurar no Redis.

Para isso você precisará do redis instalado localmente na sua máquina e precisará obrigatoriamente do REDIS_ADDRESS e do REDIS_EXPIRE_DURATION_MINUTES definidos.

COPIAR

CLIENT_ID=encrypted.<Seu client id> \
CLIENT_SECRET='encrypted.<Seu client secret>' \
REDIS_ADDRESS=redis://localhost:6379 \
REDIS_EXPIRE_DURATION_MINUTES=60 \
SPRING_PROFILES_ACTIVE=development,redis \
./guiabolso_connector_client_1.0.0/bin/application

Glossário de Variáveis de Ambiente

Estes são os possíveis valores para cada variável de ambiente.

Variável		Descrição
`CLIENT_ID`	OBRIGATÓRIO	ID da sua chave de API.
`CLIENT_SECRET`	OBRIGATÓRIO	Secret da sua chave de API.
`SPRING_PROFILES_ACTIVE`	OPCIONAL	Perfil spring, por padrão, "development".
`DATAPACKAGES_PATH`	OPCIONAL	Caminho absoluto do arquivo datapackage.yml, por padrão, usa o default.
`CAFFEINE_MAXIMUM_SIZE`	OPCIONAL	Máximo de entradas no cache. por padrão, 1000.
`CAFFEINE_EXPIRE_DURATION_MINUTES`	OPCIONAL	Tempo em minutos de expiração após o dado ser adicionado no cache, por padrão, 10 minutos.
`REDIS_ADDRESS`	OBRIGATÓRIO	Endereço do servidor redis. Se estiver usando cluster, basta separar os endereços por vírgulas, por padrão, `redis://localhost:6379`
`REDIS_EXPIRE_DURATION_MINUTES`	OBRIGATÓRIO	Tempo em minutos de expiração após o dado ser adicionado no cache, por padrão, 30 minutos.

Próximos passos

connector

Como configurar na AWS

Descompacte o arquivo .zip em uma pasta de sua preferência e execute o seguinte comando...

connector

Como configurar no GCP

Descompacte o arquivo .zip em uma pasta de sua preferência e execute o seguinte comando...

connector

Pacote de Dados

O Connector possui a capacidade de configurar como e quando os dados serão ...