lzocateli/angular-cli repository overview

⁠Angular CLI 22 sobre Node.js 24 LTS

Imagem para uso de Angular CLI 22 em ambiente containerizado, baseada em lzocateli/node:24.15.0-bookworm e preparada para scaffolding, build e ng serve em projetos Angular.

⁠Referencia da imagem

⁠Conteudo e finalidade

⁠Incluido

• Angular CLI 22 instalado globalmente.
• Node.js 24 LTS via imagem base lzocateli/node.
• Entrypoint que redireciona comandos desconhecidos para ng.

⁠Nao incluido

• Projeto Angular pronto ou dependencias de aplicacao.
• Navegadores para testes E2E.
• Secrets, tokens de registry e arquivos .npmrc sensiveis.

⁠Inicio rapido

docker pull lzocateli/angular-cli:22.1.0-node24.15.0-bookworm
docker run --rm lzocateli/angular-cli:22.1.0-node24.15.0-bookworm ng version

Executar comandos ng em projeto local:

docker run --rm -it \
  -v "$(pwd):/workspace" \
  -w /workspace \
  -p 4200:4200 \
  lzocateli/angular-cli:22.1.0-node24.15.0-bookworm \
  ng serve --host 0.0.0.0

⁠Docker Compose

services:
  angular-cli:
    image: lzocateli/angular-cli:22.1.0-node24.15.0-bookworm
    working_dir: /workspace
    user: "node"
    command: ["ng", "version"]
    ports:
      - "4200:4200"
    volumes:
      - /caminho/absoluto/projeto-angular:/workspace

⁠Configuracao

⁠Variaveis de ambiente

⁠Portas

⁠Persistencia e mounts

⁠Secrets

Forneca secrets de npm/registry apenas em runtime. Nao armazene .npmrc com tokens no repositorio nem no contexto de build.

⁠Inicializacao e ciclo de vida

O entrypoint angular-entrypoint.sh executa o comando recebido; quando o primeiro argumento nao e um executavel do sistema ou for uma flag, ele antepoe ng automaticamente para facilitar o uso.

⁠Seguranca

• Container executa como usuario node por padrao.
• Sem privilegios extras ou bind mounts sensiveis obrigatorios.
• Evite montar credenciais no workspace quando nao forem necessarias.

⁠Build local

Como a base lzocateli/node:24.15.0-bookworm ainda nao foi publicada no registry, gere localmente antes:

docker build --pull --tag lzocateli/node:24.15.0-bookworm node

Depois, gere a imagem angular-cli:

docker build --pull --tag lzocateli/angular-cli:22.1.0-node24.15.0-bookworm angular-cli

⁠Tags e compatibilidade

Use sempre tags imutaveis em pipeline.

⁠Validacao

Antes da publicacao, confirme:

• .gitignore e .dockerignore presentes e atualizados;
• exclusao de .env, secrets e .git do contexto Docker;
• docker buildx build --check sem erros;
• build para linux/amd64;
• ng version executando com Node 24.15.0 e Angular CLI 22;
• scan de vulnerabilidades, SBOM e proveniencia no workflow oficial.

⁠Publicacao

Use Actions > Publicar imagem de container > Run workflow com:

• context_path: angular-cli;
• image_name: angular-cli;
• image_tag: 22.1.0-node24.15.0-bookworm;
• dockerfile: Dockerfile;
• platforms: linux/amd64.

⁠Troubleshooting

⁠Limitacoes conhecidas

• Plataforma validada neste repositorio: linux/amd64.
• Imagem nao inclui navegador para E2E.
• Requer imagem base lzocateli/node:24.15.0-bookworm disponivel localmente ou publicada.

⁠Licencas e fontes

O badge MIT descreve somente o conteudo original deste repositorio. Componentes de terceiros permanecem sujeitos aos seus termos e avisos de licenca. Consulte a politica de licenciamento: https://github.com/lzocateli/containers/blob/main/LICENSING.md⁠.

⁠Historico de alteracoes

• 22.1.0-node24.15.0-bookworm: atualiza base para Node 24 LTS, adota Angular CLI 22 e padroniza contrato da imagem.