Instalacao

Para executar a ferramenta CLI do Kubetail (kubetail) dentro de um contêiner, voce pode usar a imagem Docker kubetail-cli. A imagem e publicada no Docker Hub e no GitHub Container Registry a cada release:

Registry	Image
Docker Hub	kubetail/kubetail-cli
GHCR	ghcr.io/kubetail-org/kubetail-cli

Ha duas variantes disponiveis:

Sufixo da tag	Imagem base	Descricao
(nenhum)	scratch	Imagem minima, menor footprint
-alpine	alpine	Inclui shell e utilitarios padrao

Docker Run

Para usar a ferramenta CLI localmente com docker run, voce precisa montar seu arquivo local .kube/config em um contêiner kubetail-cli:

docker run --rm -it \
  -v ~/.kube/config:/root/.kube/config:ro \
  kubetail/kubetail-cli logs \
  --kubeconfig /root/.kube/config \
  -f \
  deployments/my-app

Voce tambem pode usar o entrypoint sh para iniciar uma sessao interativa:

docker run --rm -it \
  -v ~/.kube/config:/root/.kube/config:ro \
  --entrypoint sh \
  kubetail/kubetail-cli

Docker Compose

Para usar a ferramenta CLI localmente com docker-compose, voce pode usar este arquivo de configuracao docker-compose.yml como ponto de partida:

curl -LO https://raw.githubusercontent.com/kubetail-org/kubetail/refs/heads/main/config/examples/docker-compose.yml
docker-compose up

Isso montara seu arquivo local .kube/config em um contêiner kubetail-cli e iniciara o servidor do dashboard em http://localhost:7500.

Kubernetes Pod

Para usar a ferramenta CLI dentro de um cluster, voce pode usar este manifesto kubetail-cli-pod.yaml como ponto de partida:

kubectl add -f https://raw.githubusercontent.com/kubetail-org/kubetail/refs/heads/main/config/examples/kubetail-cli-pod.yaml

Isso iniciara um contêiner kubetail-cli dentro do namespace padrao, com acesso aos logs de pod no mesmo namespace. Quando o pod estiver em execucao, voce podera entrar com exec e executar comandos CLI usando a flag --in-cluster:

kubectl exec -it kubetail-cli -- sh
# ./kubetail logs --in-cluster -f deployments/my-app