Docker

Se você implantou um Pentaho Server de arquivo, então copie de:

/opt/pentaho/software/pentaho-server-ee-version

Caso contrário, baixe o pacote de Portal do Cliente Pentaho.

Se a porta 8080 estiver em uso por outro aplicativo, você pode alterar a variável PORT no arquivo .env para qualquer porta disponível (por exemplo, 8090, 8081, 9090).

Arquivos de Documentação:

README.md - A principal documentação de entrada, fornecendo visão geral do projeto, instruções de início rápido, pré-requisitos e informações gerais de uso para o workshop.

ARCHITECTURE.md - Documentação técnica detalhada cobrindo a arquitetura do sistema, relacionamentos entre componentes, design de containers, rede, fluxo de dados e decisões arquiteturais para a implantação baseada em Docker.

CONFIGURATION.md - Guia abrangente de referência de configuração detalhando todas as variáveis de ambiente, opções de configuração, parâmetros de personalização e definições para os componentes Pentaho Server e PostgreSQL.

TROUBLESHOOTING.md - Guia de solução de problemas com questões comuns, mensagens de erro, procedimentos de diagnóstico e soluções para problemas de implantação e tempo de execução que você pode encontrar.

Orquestração e Implantação:

docker-compose.yml - O arquivo de definições de serviços do Docker Compose que declara todos os containers (Pentaho Server, PostgreSQL, potencialmente Vault/outros serviços), suas configurações, rede, volumes e dependências.

Makefile - Contém alvos de comando de conveniência para operações comuns como construir, iniciar, parar e limpar o ambiente. Os usuários podem executar make help para ver os comandos disponíveis.

deploy.sh - Script automatizado de implantação que provavelmente lida com o fluxo completo de implantação, incluindo validação do ambiente, construção de imagens, inicialização de serviços e configuração inicial.

Configuração do Ambiente:

.env - O arquivo de configuração de ambiente ativo (criado a partir do modelo) contendo valores reais para senhas de banco de dados, portas, hostnames e outras configurações específicas do ambiente. Este arquivo geralmente é ignorado pelo git.

.env.template - O arquivo de modelo com valores padrão e placeholders que os usuários copiam para criar seu .env arquivo, fornecendo uma referência para todas as variáveis de ambiente configuráveis.

A docker/ o diretório contém todos os componentes principais necessários para construir e executar a implantação containerizada do Pentaho Server:

Dockerfile - Esta é a principal configuração de build usando uma abordagem de build multiestágio para criar a imagem do container do Pentaho Server. Builds multiestágio ajudam a otimizar o tamanho final da imagem ao separar o ambiente de build do ambiente de execução.

entrypoint/ o diretório contém o docker-entrypoint.sh script, que é o script de inicialização executado quando o container inicia. Isso normalmente lida com tarefas como configuração de ambiente, gerenciamento de configuração, verificações de integridade e inicialização dos serviços do Pentaho Server.

stagedArtifacts/ o diretório serve como área de preparação para o pacote de instalação do Pentaho Server. Atualmente contém pentaho-server-ee-11.0.0.0-237.zip, que é a versão Enterprise Edition build 237 da versão 11.0.0.0 que é extraída e instalada durante o processo de build da imagem Docker.

A db_init_postgres/ o diretório contém os scripts de inicialização do banco de dados PostgreSQL que configuram todos os esquemas exigidos pelo Pentaho Server 11. Esses scripts são numerados para serem executados em uma sequência específica:

1_create_jcr_postgresql.sql - Cria o Jackrabbit Content Repository (JCR) esquema, que armazena o conteúdo do repositório Pentaho, incluindo arquivos de solução, agendas, relatórios, painéis e metadados. Este é o sistema central de gerenciamento de conteúdo do Pentaho.

2_create_quartz_postgresql.sql - Configura o Quartz Scheduler esquema, que gerencia todos os jobs e tarefas agendados dentro do Pentaho Server, incluindo geração de relatórios, execuções ETL e outros processos automatizados.

3_create_repository_postgresql.sql - Cria o Hibernate Repository esquema, que armazena autenticação de usuários, dados de autorização, funções, permissões e outras informações relacionadas à segurança gerenciadas pelo subsistema de segurança do Pentaho.

4_pentaho_logging_postgresql.sql - Estabelece o Audit and Data Integration (DI) Logging esquema para capturar logs de execução, métricas de jobs/transformações e informações de trilha de auditoria dos processos PDI em execução no servidor.

5_pentaho_mart_postgresql.sql - Cria o Operations Mart esquema, que armazena dados analíticos operacionais sobre o uso do Pentaho Server, métricas de desempenho e informações de monitoramento do sistema usadas pelo painel Pentaho Operations Mart.

postgres-config/ - Configuração do PostgreSQL

custom.conf - Parâmetros personalizados de ajuste de desempenho do PostgreSQL otimizados para cargas de trabalho do Pentaho Server. Isso provavelmente inclui configurações para shared buffers, work memory, limites de conexão, configurações de checkpoint e outros parâmetros relacionados ao desempenho, ajustados para lidar com os requisitos de banco de dados do Pentaho.

pg_hba.conf - Arquivo de configuração de autenticação baseada em host do PostgreSQL que controla métodos de autenticação de conexão do cliente, regras de acesso por endereço IP e políticas de segurança para conexões de banco de dados a partir do container Pentaho Server.

vault/ - Integração com o HashiCorp Vault

Este diretório oferece suporte à incorporação do Vault para gerenciamento de segredos:

config/vault.hcl - O arquivo de configuração do servidor HashiCorp Vault que define o backend de armazenamento, as configurações do listener, os endpoints da API, o comportamento de seal/unseal e os parâmetros operacionais gerais do servidor Vault.

policies/pentaho-policy.hcl - Política de controle de acesso do Vault especificamente para o Pentaho Server, definindo quais caminhos de segredos a aplicação Pentaho pode ler, gravar ou gerenciar. Isso impõe acesso de menor privilégio a credenciais sensíveis.

secrets/ - Gerenciamento de Secrets do Docker

postgres_password.txt - Um arquivo de secrets do Docker contendo a senha do PostgreSQL. Ao usar secrets do Docker (ou integração com Vault), este arquivo fornece as credenciais do banco de dados de forma segura, em vez de passá-las como variáveis de ambiente em texto simples. O arquivo deve ter permissões restritas e geralmente é referenciado pelo Docker Compose usando o secrets: configuração.

A softwareOverride/ o diretório contém arquivos de configuração personalizados e componentes que substituem a instalação padrão do Pentaho Server. A estrutura numerada garante uma organização lógica e, potencialmente, uma aplicação ordenada durante o processo de build do Docker:

1_drivers/ - Drivers de Banco de Dados JDBC

tomcat/lib/ - Contém arquivos JAR de drivers JDBC (especificamente o driver JDBC do PostgreSQL) que são copiados para o diretório de bibliotecas do Tomcat, permitindo que o Pentaho Server se conecte a bancos de dados PostgreSQL.

2_repository/ - Configuração do Repositório de Banco de Dados

Esta seção configura a conexão do Pentaho com todos os repositórios baseados em PostgreSQL:

pentaho-solutions/system/hibernate/ - Arquivos de configuração do repositório Hibernate (repository.xml, hibernate-settings.xml) para dados de segurança de usuários/funções

pentaho-solutions/system/jackrabbit/ - Configuração do repositório Jackrabbit JCR (repository.xml) para armazenamento de conteúdo

pentaho-solutions/system/scheduler-plugin/quartz/ - Configuração do banco de dados do agendador Quartz (quartz.properties) para agendamento de jobs

tomcat/webapps/pentaho/META-INF/ - Contém context.xml com definições de datasources JNDI para todos os bancos de dados Pentaho (Quartz, Jackrabbit, Hibernate, Audit, Operations Mart)

3_security/ - Configurações de Autenticação e Segurança

pentaho-solutions/system/ - Arquivos de configuração de segurança incluindo applicationContext-security.xml, security.properties e possivelmente configurações LDAP/SSO para autenticação e autorização.

4_others/ - Configurações Adicionais do Tomcat e da Aplicação

pentaho-solutions/system/ - Outras configurações em nível de sistema como pentaho.xml, pentaho-spring-beans.xml, configurações do log4j e configurações de comportamento da aplicação

tomcat/ - Personalizações do servidor Tomcat incluindo server.xml, web.xml, setenv.sh para parâmetros da JVM e outros ajustes específicos do Tomcat

A scripts/ o diretório contém utilitários operacionais e de manutenção para gerenciar a implantação do Pentaho Server, organizados por área funcional:

Gerenciamento de Banco de Dados:

backup-postgres.sh - Utilitário automatizado de backup do PostgreSQL que cria dumps de todos os bancos de dados do Pentaho (JCR, Quartz, Hibernate, Audit, Operations Mart). Provavelmente inclui lógica de carimbo de data/hora, compressão e retenção de backups.

restore-postgres.sh - Utilitário de restauração de banco de dados para recuperar os bancos de dados do Pentaho a partir de arquivos de backup, útil para recuperação de desastres, clonagem de ambiente ou migração de dados entre instâncias.

Gerenciamento de Vault/Segredos:

backup-vault.sh - Script de backup das credenciais e chaves de unseal do HashiCorp Vault, garantindo capacidade de recuperação para a instância do Vault que contém credenciais sensíveis do Pentaho.

restore-vault.sh - Utilitário de restauração do Vault para recuperar os dados do Vault e reinicializar o sistema de gerenciamento de segredos a partir do backup.

rotate-secrets.sh - Script automatizado de rotação de senhas que atualiza as senhas do banco de dados e outras credenciais sensíveis no Vault, e então propaga as alterações para a configuração do Pentaho Server - apoiando as melhores práticas de segurança.

fetch-secrets.sh - Utilitário auxiliar para recuperar segredos do Vault programaticamente, útil para scripts que precisam acessar credenciais sem codificá-las diretamente.

vault-init.sh - Script inicial de configuração do Vault que lida com a inicialização do Vault, unseal, criação da política do Pentaho e armazenamento dos segredos iniciais para a implantação.

Operações e Validação:

validate-deployment.sh - Script de validação da implantação que executa verificações de integridade em todos os componentes (conectividade com PostgreSQL, inicialização do Pentaho Server, acessibilidade do Vault, disponibilidade dos serviços), confirmando que o ambiente está configurado corretamente e operacional.

config/ - Configuração da Aplicação

Este diretório armazena arquivos de configuração no nível do usuário e da aplicação:

.kettle/ - Diretório de configuração do PDI (Pentaho Data Integration) / Kettle

.pentaho/ - Diretório de configurações do usuário Pentaho para armazenar preferências específicas do usuário, metadados em cache e informações de estado da aplicação.

backups/ - Armazenamento de Backup do Banco de Dados

*.sql.gz - Repositório para arquivos compactados de backup do banco de dados PostgreSQL criados pelo backup-postgres.sh script. A compressão gzip reduz os requisitos de armazenamento enquanto mantém snapshots completos do banco de dados para cenários de recuperação de desastres, clonagem de ambiente ou reversão. Os arquivos de backup provavelmente usam carimbo de data/hora para controle de versão.

logs/ - Registro da Aplicação

Diretório centralizado de logs para capturar logs de tempo de execução de todos os serviços. Isso provavelmente inclui:

Isso oferece suporte à configuração de rotação de logs e aos recursos de monitoramento que você vem incorporando à sua implantação, facilitando a resolução de problemas e a auditoria durante os workshops.

A softwareOverride/ diretório fornece um mecanismo poderoso para personalizar o Pentaho Server sem modificar a instalação principal. Os arquivos são copiados para a instalação do Pentaho durante a inicialização do contêiner, processados em ordem alfabética pelo nome do diretório.