Introdução
Nesta quarta postagem sobre o Couchbase Mobile pilha, veremos como instalar Gateway de sincronização.
Procure outras postagens da minha série "Getting Comfortable with Couchbase Mobile" para saber tudo o que você precisa para colocar toda a pilha do Couchbase Mobile em funcionamento em sua máquina de desenvolvimento. (Links fornecidos no final).
Histórico
Para se familiarizar com toda a pilha, é ótimo instalar e executar tudo em uma única máquina. Nesta série de postagens, explicarei as etapas para começar a usar cada componente. Também mostrarei como fazer uma pequena exploração extra ao longo do caminho.
Farei apenas a configuração mínima. O objetivo não é explicar o que é necessário para um ambiente de produção. Presumo que você esteja familiarizado com alguns conceitos básicos de NoSQL, tenha algum conhecimento do Couchbase e saiba como criar aplicativos em algo como Java,
Android ou iOS. Se você quiser ler sobre bancos de dados NoSQL ou Couchbase, poderá encontrar muitos recursos no site Couchbase local.
O Couchbase é de código aberto. Tudo o que usarei aqui é gratuito para ser testado. Consulte o final da postagem para obter mais recursos se precisar de ajuda.
Gateway de sincronização
O Sync Gateway é um aplicativo de gateway da Web seguro com APIs de sincronização, REST, fluxo, lote e evento para acessar e sincronizar dados pela Web. O Sync Gateway permite, entre outras coisas, a replicação segura de dados entre o Couchbase Server e o
Couchbase Lite.
O Sync Gateway tem poucas dependências e pode ser executado na maioria das distribuições Linux (mesmo no Raspberry Pi), Windows e OSX/macOS. As etapas específicas de instalação variam de acordo com a plataforma. Consulte a seção downloads para todos os pacotes disponíveis, e o site guia de instalação completo para obter detalhes completos. Para instalar
Em distribuições Linux que não sejam as suportadas, consulte esta postagem.
A seguir, apresentarei uma instalação simplificada no OSX.
OSX
Etapas iniciais de instalação
Para instalar o Sync Gateway, primeiro faça o download do arquivo tar compactado para Mac aqui. Você obterá um arquivo chamado algo como couchbase-sync-gateway-enterprise_1.3.1.1-1_x86_64.tar.gz.
Descompacte o arquivo, clicando duas vezes no arquivo no Finder ou, na linha de comando, usando o seguinte:
|
1 |
$ alcatrão xzf couchbase-sincronização-portal-enterprise_1.3.1.1-1_x86_64.tar.gz |
Isso cria vários arquivos. Nós nos preocuparemos apenas com o binário sync_gateway e com os arquivos de configuração de exemplo.
Abra um shell de linha de comando (por exemplo, Terminal). Altere seu diretório de trabalho para o local onde você descompactou o arquivo. No meu caso, coloquei-os em meu diretório pessoal em workspace/servers/couchbase-sync-gateway.
|
1 |
$ cd ~/espaço de trabalho/servidores/couchbase-sincronização-portal |
Inicie a execução do Sync Gateway usando um dos arquivos de configuração de exemplo.
|
1 |
$ ./caixa/portais de sincronização exemplos/básico-couchbase-balde.json |
Você deverá ver um resultado parecido com este:
|
1 2 3 4 5 6 |
2016-09-15T15:07:13.356-07:00 Habilitação registro: [*] 2016-09-15T15:07:13.356-07:00 ==== Couchbase Sincronização Gateway/1.3.1(16;f18e833) ==== ... 2016-09-15T15:07:13.535-07:00 Início administrador servidor em 127.0.0.1:4985 2016-09-15T15:07:13.539-07:00 Início servidor em :4984 ... 2016-09-15T15:07:14.659-07:00 Mudanças+: Notificação que "default" alterado (chaves="{_sync:user:}") contagem=2 |
Isso é tudo o que é necessário para colocar o Sync Gateway em funcionamento. O arquivo de configuração de exemplo que usei aqui tem as configurações necessárias para usar os outros exemplos que darei neste e nos blogs relacionados.
Esse requer que você tenha o Couchbase Server instalado e em execução ao mesmo tempo. Se você quiser experimentar o Sync Gateway em execução autônoma, use
|
1 |
$ ./caixa/portais de sincronização exemplos/básico-morsa-balde.json |
Em vez disso.
Verificação da instalação
Para verificar se o Sync Gateway está em execução, você pode fazer algumas coisas.
Na linha de comando, use enrolar para verificar a mensagem de boas-vindas da seguinte forma:
|
1 |
$ enrolar localhost:4985 |
Você deverá ver um resultado parecido com este:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
HTTP/1.1 200 OK Conteúdo-Comprimento: 144 Conteúdo-Tipo: aplicativo/json Data: Assim, 15 Setembro 2016 22:09:54 GMT Servidor: Couchbase Sincronização Gateway/1.3.1 { "ADMIN": verdadeiro, "couchdb": "Bem-vindo", "vendor" (fornecedor): { "name" (nome): "Gateway de sincronização do Couchbase", "versão": 1.3 }, "versão": "Couchbase Sync Gateway/1.3.1(16;f18e833)" } |
Acesse a interface administrativa navegando em um navegador para http://localhost:4985/_admin/.
Você verá esta página de nível superior:
Se você clicar em db na lista de bancos de dados, verá esta página:
Os links aqui permitirão que você veja muitas informações interessantes enquanto o Sync Gateway estiver em execução. Exploraremos mais quando analisarmos a pilha completa operando em conjunto.
Links úteis
Por fim, aqui estão algumas outras páginas que você pode explorar para saber mais sobre o Sync Gateway.
https://developer.couchbase.com/documentation/mobile/current/installation/sync-gateway/index.html
https://developer.couchbase.com/documentation/mobile/current/guides/sync-gateway/index.html
https://github.com/couchbase/sync_gateway/wiki
Próximas etapas
Na próxima postagem desta série, mostrarei algumas maneiras de trabalhar com o Sync Gateway a partir da linha de comando. Isso ajudará a entender como o Sync Gateway funciona e lhe dará algumas ferramentas para diagnosticar problemas e erros comuns. Em seguida, examinaremos um aplicativo de amostra usando o Couchbase Lite. Por fim, usaremos esse aplicativo de amostra para voltar e ver como tudo está interligado.
[buttongroup][button style="btn-link btn-lg" icon="fa fa-arrow-left" align="left" iconcolor="#dd3333″ type="link" target="false" title="Anterior: Servidor Couchbase por meio da linha de comando" link="https://www.couchbase.com/blog/getting-comfortable-couchbase-mobile-couchbase-server-command-line/" linkrel=""][button style="btn-link btn-lg" icon="fa fa-arrow-right" align="left" iconcolor="#dd3333″ type="link" target="false" title="Next: Sync Gateway via linha de comando" link="https://www.couchbase.com/blog/getting-comfortable-with-couchbase-mobile-sync-gateway-via-the-command-line/" linkrel=""][/buttongroup]
Pós-escrito
Confira mais recursos em nosso portal do desenvolvedor e nos siga no Twitter @CouchbaseDev.
Você pode postar perguntas em nosso fóruns. E participamos ativamente de Estouro de pilha.
Você pode me seguir pessoalmente em @HodGreeley
[...] Couchbase Server e Couchbase Lite e/ou PouchDB. Para obter um guia rápido sobre como instalá-lo, consulte este guia. Se o Sync Gateway estiver instalado, ele poderá ser acessado na seção http://localhost:4984 quando [...]
[...] Anterior: Instalando o Sync Gateway Próximo: TBD [...]
[...] O Couchbase Mobile Stack compreende o Couchbase Server, o Couchbase Sync Gateway e o banco de dados incorporado Couchbase Lite. Você pode saber mais sobre o servidor no guia Introdução ao Couchbase Server e sobre o Sync Gateway no guia Introdução ao Couchbase Sync Gateway. [...]
[...] siga as instruções na postagem do blog para instalar o Sync Gateway em seu ambiente de desenvolvimento do Mac OS. Consulte o site de downloads para obter todos os pacotes disponíveis e [...]
[...] Se quiser saber mais sobre como configurar o Sync Gateway em sua máquina de desenvolvimento ou como trabalhar com ele a partir da linha de comando, dê uma olhada nesta série do blog. [...]