ansible role solr

Função Ansible: Apache Solr

Instala o Apache Solr em servidores Linux.

Requisitos

Java deve estar disponível no servidor. Você pode instalar o Java facilmente usando a função geerlingguy.java . Certifique-se de que a versão Java instalada atenda aos requisitos mínimos do Solr (por exemplo, Java 8 para Solr 6+).

Esta função está atualmente testada e funcionando com Solr 3.x, 4.x, 5.x, 6.x, 7.x e 8.x.

Variáveis ​​de função

As variáveis ​​disponíveis estão listadas abaixo, juntamente com os valores padrão (consulte defaults/main.yml ):

 solr_workspace: /root

Os arquivos serão baixados para este caminho no servidor remoto antes de serem movidos para o local.

 solr_create_user: true
solr_user: solr
solr_group: "{{ solr_user }}"

Solr será executado sob solr_user . Defina solr_create_user como false se solr_user for criado antes da execução desta função ou se você estiver usando o Solr 5+ e desejar que o script de instalação do próprio Solr configure o usuário. Por padrão, solr_group é igual solr_user , mas pode ser substituído para se ajustar à sua própria configuração.

 solr_version: "8.11.2"

A versão do Apache Solr a ser instalada. Para obter uma lista completa, consulte as versões disponíveis do Apache Solr.

 solr_mirror: "https://archive.apache.org/dist"

O espelho do Projeto Apache do qual o tarball do Solr será baixado. Em caso de baixa velocidade de download ou tempo limite, é útil definir o espelho como sugerido pelo site de download de espelhos do Apache.

 solr_remove_cruft: false

Se deseja remover documentação e exemplos desnecessários do diretório solr.

 solr_service_manage: true
solr_service_name: solr
solr_service_state: started

Por padrão, esta função gerenciará o serviço solr , garantindo que ele esteja habilitado na inicialização do sistema e em execução. Você pode garantir que o Solr seja interrompido definindo solr_service_state: stopped , ou pode desabilitar totalmente o gerenciamento desta função do serviço solr definindo solr_service_manage: false . Você também pode definir solr_restart_handler_enabled: false (documentado posteriormente) neste caso.

 solr_install_dir: /opt
solr_install_path: /opt/solr

O caminho onde o Apache Solr será instalado. Para Solr 5+, solr_install_dir será usado pelo script de instalação do Solr. Para Solr < 5, os arquivos de instalação do Solr serão copiados no local em solr_install_path .

 solr_home: /var/solr

O caminho onde os dados locais do Solr (coleções e configurações de pesquisa) serão armazenados. Normalmente deve estar fora de solr_path , para facilitar as atualizações do Solr.

 solr_port: "8983"

A porta na qual o Solr será executado.

 solr_xms: "256M"
solr_xmx: "512M"

Configurações de memória para a JVM. Eles devem ser definidos o mais alto possível para permitir o melhor desempenho e reduzir a chance de o Solr reiniciar devido a situações de OOM.

 solr_timezone: "UTC"

Fuso horário padrão da JVM executando o solr. Você pode substituir isso, se necessário, ao usar importação de dados e importações delta (ex: comparação com uma fonte de dados externa do MySQL). Leia a documentação Trabalhando com Datas do Apache Solr para obter mais informações.

 solr_opts: "$SOLR_OPTS -Dlog4j2.formatMsgNoLookups=true"

Opções Solr. Esta opção foi adicionada à função em parte para mitigar o CVE-2021-44228.

 solr_cores:
  - collection1

Uma lista de núcleos/coleções que devem existir no servidor. Cada um será criado (se ainda não existir) usando o exemplo de configuração padrão que acompanha o Solr. Observe que esta variável se aplica apenas ao usar Solr 5+.

 solr_connect_host: localhost

O nome do host ou endereço IP no qual o Solr estará acessível. localhost deve funcionar na maioria das circunstâncias, mas há casos especiais em que você só poderá acessar a instância local do Solr por meio de outro IP ou nome de host.

 solr_restart_handler_enabled: true

Se o manipulador restart solr deve ser usado ou não. Se você estiver criando contêineres ou AMIs, talvez seja necessário desabilitar o manipulador de reinicialização para uma execução de provisionamento.

Variáveis ​​usadas apenas para Solr < 5.

As seguintes variáveis ​​são atualmente aplicadas apenas a instalações do Solr 4 e inferiores:

 solr_log_file_path: /var/log/solr.log

Caminho onde o arquivo de log do Solr será criado.

 solr_host: "0.0.0.0"

O nome do host ou endereço IP ao qual o Solr se vinculará. O padrão é 0.0.0.0 , o que permite que o Solr escute em todas as interfaces.

Dependências

Nenhum.

Manual de exemplo

 - hosts: solr-servers
  roles:
    - geerlingguy.java
    - geerlingguy.solr

Licença

MIT/BSD

Informações do autor

Essa função foi criada em 2014 por Jeff Geerling, autor de Ansible for DevOps.