Docker Logs

Author: denisecase

docs/docker-cloud.md

@@ -1,5 +1,7 @@
 # Alternative Execution: Containers in the Cloud (GitHub Actions)
 
+> Optional Exploration (not required)
+
 This project can be packaged and executed
 in a Docker container without installing Docker locally.
 
@@ -39,79 +41,50 @@ Docker Desktop is **not** recommended on many Windows machines.
 
 ## Step 1. Add a Dockerfile
 
-Create a file named `Dockerfile` in the project root:
-
-```dockerfile
-FROM python:3.14-slim
-
-WORKDIR /app
-
-COPY . .
-
-RUN pip install --no-cache-dir uv
+Create a file named `Dockerfile` in the project root.
 
-RUN uv self update
-RUN uv python pin 3.14
-RUN uv sync --extra dev --extra docs --upgrade
-
-CMD ["uv", "run", "python", "-m", "cintel.continuous_intelligence_case"]
-```
+See the example file provided.
 
 IMPORTANT: Adjust the final command when your custom project
 entry point (the module name) differs.
 
 ## Step 2. Add a GitHub Actions Workflow
 
-Create the file:
-
-.github/workflows/docker-build.yml
-
-```yaml
-name: Container Build and Run
+Create a file: `.github/workflows/deploy-docker.yml`
 
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-jobs:
-  build-run:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Build container
-        run: docker build -t cintel-pipeline .
-
-      - name: Run container
-        run: docker run cintel-pipeline
-```
+See the example file provided.
 
 ## Step 3. Run the Workflow
 
 1. Push your changes to GitHub
 2. Open the Actions tab
-3. Select the workflow
-4. View logs for:
-   - container build steps
-   - pipeline execution output
+3. Select the workflow with the name e.g. `Docker Container and Quality Checks`
+4. Look for:
+   - Job 1 - Run Docker pre-commit
+   - Job 2 - Build Docker image
+   - Job 3 - Run project in container
+5. Click to expand **Job 3 A3) Run project** to see the logs:
 
 You should see:
 
+```text
+========================
 Pipeline executed successfully!
+========================
+```
 
-## What to Observe
+## Explore
 
 As the workflow runs, note:
 
 - how dependencies are installed inside the container
 - how the pipeline runs without your local environment
 - any errors during build or execution
 
-These logs provide insight into how software is packaged and executed in production systems.
+These logs provide insight into how software
+is packaged and executed in production systems.
 
-## Optional: Share Your Results
+## Share Your Results
 
 If you experiment with containers, document:
 
@@ -121,18 +94,10 @@ If you experiment with containers, document:
 - performance observations
 - link to your repository
 
-## Summary
-
-- Containers package code and environment together
-- GitHub Actions can build and run containers in the cloud
-- This avoids local setup issues while exposing real-world tooling
-
-This is an optional extension. The core project does not require containers.
-
-## Notes
+## Reusability
 
 This pattern is reusable across projects:
 
 - Dockerfile defines execution environment
 - GitHub Actions provides remote execution
-- No local Docker required
+- No local Docker installation is required (nice for Windows users)