For the complete documentation index, see llms.txt. This page is also available as Markdown.

Contêineres do Pentaho

Contêineres do Pentaho

O Pentaho Server oferece opções flexíveis de implantação para atender a uma variedade de estratégias de infraestrutura. Para local ambientes, as organizações podem implantar usando Docker Compose para configurações simples em um único host, ou orquestrar em clusters usando Kubernetes (K8s & K3s) para maior escalabilidade e resiliência.

Para nuvem (hiperescalador) implantações, o Pentaho fornece imagens Docker otimizadas e pré-construídas, desenvolvidas especificamente para Amazon Web Services (EKS/ECR), Microsoft Azure (AKS) e Google Cloud Platform (GKE), permitindo que as equipes aproveitem serviços Kubernetes gerenciados e armazenamento nativo da nuvem como o Amazon S3. A partir do Pentaho 11, essas imagens apresentam caminhos de instalação padronizados, variáveis de ambiente e scripts entrypoint aprimorados que oferecem suporte a substituições de configuração em tempo de execução - o que significa que licenças e arquivos de configuração podem ser injetados na inicialização sem reconstruir a imagem.

Uma híbrida abordagem também é totalmente suportada, na qual as organizações podem executar o Pentaho Server localmente para cargas de trabalho sensíveis enquanto implantam contêineres do servidor Carte ou nós de trabalho do PDI na nuvem para lidar com picos de processamento, combinando o controle da infraestrutura local com a elasticidade dos recursos da nuvem.

Selecione seu host de contêiner:

Docker

Docker é uma plataforma que permite aos desenvolvedores empacotar aplicativos e suas dependências em contêineres leves e portáteis. Os contêineres garantem que os aplicativos sejam executados de forma consistente em diferentes ambientes de computação, de laptops de desenvolvimento a servidores de produção. Este workshop orientará você pelo processo completo de instalação do Docker Engine no Ubuntu 24.04 LTS (Noble Numbat).

  1. Antes de instalar o Docker, atualize sua lista de pacotes existente.

sudo apt update && sudo apt upgrade
  1. Instale os pacotes que permitem ao apt usar repositórios via HTTPS.

sudo apt install -y ca-certificates curl gnupg lsb-release
  1. Crie um diretório para keyrings e adicione a chave GPG do Docker.

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
  1. Adicione o repositório Docker às suas fontes do apt.

echo \\
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \\
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \\
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. Agora que o repositório Docker foi adicionado, atualize o índice de pacotes.

sudo apt update && sudo apt upgrade
  1. Instale o Docker Engine, o containerd e o Docker Compose.

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Verifique se o Docker foi instalado corretamente conferindo a versão.

Você deverá ver uma saída semelhante a (nov 2025):

  1. Verifique se o Docker Engine está em execução.

O serviço deve aparecer como "active (running)".

  1. Sair.

  1. Teste sua instalação do Docker executando o contêiner hello-world.

Este comando baixa uma imagem de teste e a executa em um contêiner. Se tiver sucesso, você verá uma mensagem confirmando que o Docker está funcionando corretamente.


Sem Sudo

Por padrão, o Docker requer privilégios de sudo. Para executar comandos Docker sem sudo.

  1. Adicione seu usuário ao grupo docker.

  1. Aplique a nova associação ao grupo (ou saia e entre novamente).

  1. Verifique se você consegue executar o Docker sem sudo.

  1. Certifique-se de que o Docker inicie automaticamente quando o sistema for inicializado.


Verificação e Testes

Para confirmar que tudo está funcionando corretamente, execute os seguintes comandos:

Verifique a versão do Docker:

Veja as informações do sistema Docker:

Liste os contêineres em execução:

Liste todos os contêineres (incluindo os parados):

Liste as imagens baixadas:


Comandos Comuns

Aqui estão comandos essenciais do Docker que você usará regularmente:

  • docker pull <image> - Baixe uma imagem do Docker Hub

  • docker images - Liste todas as imagens locais

  • docker run <image> - Crie e inicie um contêiner a partir de uma imagem

  • docker ps - Liste os contêineres em execução

  • docker ps -a - Liste todos os contêineres

  • docker stop <container> - Pare um contêiner em execução

  • docker rm <container> - Remova um contêiner parado

  • docker rmi <image> - Remova uma imagem

  • docker logs <container> - Veja os logs do contêiner

  • docker exec -it <container> bash - Acesse o shell de um contêiner em execução

K3s

K3s é uma distribuição Kubernetes leve e totalmente compatível, projetada para ambientes com recursos limitados e de edge computing. Ele é empacotado como um único binário ou uma imagem de contêiner mínima, tornando sua implantação e gerenciamento significativamente mais fáceis do que o Kubernetes padrão. A distribuição usa SQLite3 como seu armazenamento padrão leve, embora também suporte etcd3, MySQL e Postgres para usuários que precisem de opções mais robustas.

A plataforma simplifica as operações do Kubernetes ao reunir todos os componentes do plano de controle em um único binário e processo. Essa abordagem unificada automatiza tarefas complexas como distribuição de certificados e configuração TLS, mantendo a segurança por padrão com configurações sensatas para ambientes leves. O K3s tem dependências externas mínimas, exigindo apenas um kernel Linux moderno e pontos de montagem cgroup para ser executado.

O K3s vem "com tudo incluído" com componentes essenciais pré-empacotados, eliminando a necessidade de instalação e configuração separadas. Isso inclui containerd para runtime de contêiner, Flannel para rede, CoreDNS para descoberta de serviços, Traefik para ingress e vários outros controladores críticos para balanceamento de carga, políticas de rede, armazenamento e gerenciamento de imagens. Esse pacote abrangente torna o K3s ideal para criação rápida de clusters em locais de edge, implantações de IoT, pipelines de CI/CD e ambientes de desenvolvimento.

  1. Antes de instalar o Docker, atualize sua lista de pacotes existente.

  1. Instale os pacotes que permitem ao apt usar repositórios via HTTPS.

  1. Desative o swap (recomendado para Kubernetes).

  1. Ative o encaminhamento de IP.

  1. Configure o firewall.


Selecione suas opções de implantação:

Instalação em Nó Único

  1. Verifique os requisitos do sistema.

  1. Instale o K3s.

Este comando:

- Baixa e instala o K3s

- Inicia o serviço K3s

- Instala o kubectl

- Configura o kubeconfig

  1. Configure o acesso ao kubectl.

4. Verificar a instalação

Verifique o K3s
  1. Verifique a instalação do K3s.

Cluster Multi-nó

Nó do Servidor (Plano de Controle)

Nós Agentes (Workers)

Em cada nó worker:

Verifique o cluster multi-nó

No nó do servidor:

  1. Adicione aliases úteis.

Configuração Pós-instalação

  1. Verifique a StorageClass padrão

  1. Configure o Ingress do Traefik

  1. Instale o Helm (opcional, mas recomendado)

4. Instale o k9s (opcional - interface de terminal)

K9s

5. Verifique a instalação do K3s.

Verifique o K3s

Charts do Helm

Helm é o gerenciador de pacotes do Kubernetes, frequentemente chamado de "apt/yum para Kubernetes". Ele simplifica a implantação e o gerenciamento de aplicativos Kubernetes por meio de:

Empacotamento: Agrupando recursos relacionados do Kubernetes

Modelagem: Parametrizando manifestos para reutilização entre ambientes

Versionamento: Gerenciando versões e atualizações do aplicativo

Gerenciamento de Releases: Acompanhando implantações e permitindo reversões

  1. Execute o seguinte script de instalação.

Instale o Helm

ou

  1. Adicione a chave GPG do Helm.

  1. Instale as dependências

  1. Adicione o repositório Helm.

  1. Atualize a lista de pacotes e instale.

  1. Verifique a instalação.


Comandos do Helm

DBeaver

Você vai precisar de uma ferramenta de gerenciamento de banco de dados. O DBeaver Community é uma ferramenta gratuita e de código aberto para gerenciamento de bancos de dados, ideal para projetos pessoais.

  1. A opção mais simples é baixar e instalar pela Snap Store.

Ou

Acesse a página oficial página de download do DBeaver

Ou

Para instalar esse arquivo DEB.

  1. Fixe o DBeaver no Dash - barra inferior.

Fazer

Um makefile é simplesmente uma forma de associar nomes curtos, chamados de alvos, a uma série de comandos a serem executados quando a ação é solicitada. Por exemplo, um alvo comum de makefile é “clean”, que geralmente executa ações para fazer a limpeza após o compilador — removendo arquivos objeto e o executável resultante.

Usaremos scripts auxiliares do Make para agilizar o processo de implantação.

  1. Atualize o sistema operacional.

  1. Verifique se o make já está instalado.

  1. Instale o pacote make.

  1. Verifique a instalação.

Atualizado

Isto foi útil?