feature: development container

[SteveDala]

Description

The motivation behind this work is to create a reproducible environment to work on the OnTrack documentation. Further to not wanting to install node.js on my Windows machine, I prefer to open a Docker or development container and just go from there. This should also solve any cross-platform dependency problems among team members.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)

How Has This Been Tested?

1. Open the repository folder in VSCode. VSCode should have the "Remote Development Extension Pack" installed.
2. Using the command palette (Ctrl + Shift + P on Windows), use the command "Reopen in Container".
3. It may take some time to build the container, but before long the Astro dev server should start within the container and become available at localhost:4322 in any browser window.
4. When saving edits to any documentation, Vite should detect the change and the page should update.

Testing Checklist

• Tested in latest Chrome
• Tested in latest Safari
• Tested in latest Firefox

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have requested a review from the Documentation Team on the Pull Request

[netlify]

✅ Deploy Preview for ontrackdocumentation ready!

Name	Link
🔨 Latest commit	3fac569
🔍 Latest deploy log	https://app.netlify.com/projects/ontrackdocumentation/deploys/69302a55e7675f00083fffb1
😎 Deploy Preview	https://deploy-preview-64--ontrackdocumentation.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Rana7xi]

Hi Steven,

I tested the development container for this PR and ran into issue when I reopen the repository in a dev container.

The Dev Containers log showed the following error:

no port specified: ..:/site<empty>

This was caused by the ..:/site entry placed under ports in
.devcontainer/docker-compose.yml. Docker Compose take it as a
port instead of volume.

After moving ..:/site from the ports section into the volumes section, the dev container successfully worked.

Here is the change that worked for me:

services:
  astro-dev:
    build:
      context: ../
      dockerfile: Dockerfile
    ports:
      - "4321:4321"
    volumes:
      - ..:/site
      - astro-node_modules:/site/node_modules
volumes:
  astro-node_modules:

[SteveDala]

Thanks @Rana7xi, I have fixed that now.

[sabdosh]

Hi Steven, it works on my side. I was able to run the localhost:4322 on my browser with no errors.

[SteveDala]

@BrianDangDev lets get this merged to assist the Documentation team with container-based development of this doc site.

[SteveDala]

@BrianDangDev, could we get this merged if all good?