chore

Author: argentinaluiz

.github/workflows/ci.yaml

@@ -0,0 +1,74 @@
+name: CI - Testcontainers
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-without-docker:
+    name: Tests - Running Outside Container
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+          cache-dependency-path: './src/16-docker-outside-of-docker/package.json'
+
+      - name: Install dependencies
+        working-directory: ./src/16-docker-outside-of-docker
+        run: npm install
+
+      - name: Run tests - Container reuse without compose (outside container)
+        working-directory: ./src/16-docker-outside-of-docker
+        env:
+          TESTCONTAINERS_RYUK_DISABLED: true
+        run: npm run test:without-compose
+
+      - name: Run tests - Container reuse with compose (outside container)
+        working-directory: ./src/16-docker-outside-of-docker
+        env:
+          TESTCONTAINERS_RYUK_DISABLED: true
+        run: npm run test:with-compose
+
+#   test-inside-docker:
+#     name: Tests - Running Inside Container (Docker-in-Docker)
+#     runs-on: ubuntu-latest
+    
+#     steps:
+#       - name: Checkout code
+#         uses: actions/checkout@v4
+
+#       - name: Set up Docker Buildx
+#         uses: docker/setup-buildx-action@v3
+
+#       - name: Start test container with docker compose
+#         working-directory: ./src/16-docker-outside-of-docker
+#         run: docker compose up -d
+
+#       - name: Install dependencies inside container
+#         working-directory: ./src/16-docker-outside-of-docker
+#         run: docker compose exec -T tests npm install
+
+#       - name: Run tests - Container reuse without compose (inside container)
+#         working-directory: ./src/16-docker-outside-of-docker
+#         run: |
+#           docker compose exec -T \
+#             -e TESTCONTAINERS_RYUK_DISABLED=true \
+#             tests npm run test:without-compose
+
+#       - name: Run tests - Container reuse with compose (inside container)
+#         working-directory: ./src/16-docker-outside-of-docker
+#         run: |
+#           docker compose exec -T \
+#             -e TESTCONTAINERS_RYUK_DISABLED=true \
+#             tests npm run test:with-compose
+
+

src/16-docker-outside-of-docker/Dockerfile

@@ -0,0 +1,17 @@
+FROM node:24.9.0-slim
+
+RUN apt update && \
+    apt install -y ca-certificates curl && \
+    install -m 0755 -d /etc/apt/keyrings && \
+    curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc && \
+    chmod a+r /etc/apt/keyrings/docker.asc && \
+    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null && \
+    apt update && \
+    apt install -y docker-ce-cli docker-buildx-plugin docker-compose-plugin
+
+RUN groupadd -f -g 999 docker && \
+    usermod -aG docker node
+
+WORKDIR /home/node/app
+
+USER node

src/16-docker-outside-of-docker/compose.yaml

@@ -0,0 +1,27 @@
+services:
+
+  tests:
+    build:
+      context: .
+    # Configurações necessárias para Testcontainers funcionar dentro de container:
+    # stop_signal: SIGKILL - envia sinal de término forçado (kill -9) ao invés de SIGTERM
+    #   Motivo: garante que o container de teste pare imediatamente junto com os containers criados pelo Testcontainers
+    #           em CI o container que executa os testes morre instantaneamente, tornando mais rápido o processo de finalização
+    stop_signal: SIGKILL
+    # stdin_open: true - mantém o STDIN (entrada padrão) aberto, equivalente ao flag -i do docker run
+    #   Motivo: necessário para o Testcontainers manter conexão com o Docker daemon
+    stdin_open: true
+    # tty: true - aloca um pseudo-terminal (TTY), equivalente ao flag -t do docker run
+    #   Motivo: necessário para o Testcontainers receber sinais do Docker daemon corretamente
+    tty: true
+    # stdin_open: true e tty: true juntos equivalem ao flag -it do docker run
+    volumes:
+      - .:/home/node/app
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ~/.docker/config-read.json:/home/node/.docker/config.json:ro
+    environment:
+      # com docker compose é criado uma network bridge customizada, então o test não consegue comunicar com ryuk
+      # com docker run funciona normalmente pois usa a network default bridge
+      - TESTCONTAINERS_HOST_OVERRIDE=host.docker.internal
+    extra_hosts:
+      - "host.docker.internal:host-gateway"