/rdb-alpha

Primary LanguageDockerfile

Prerequisites

  1. Docker Engine
  2. VS Code and the Dev Containers extension
  3. Git

How to Run a Project in Docker

  1. Clone the RDB Alpha repo with git clone https://github.com/freeCodeCamp/rdb-alpha
  2. Open a terminal, navigate to the rdb-alpha directory, and open VSCode with code .
  3. Press Ctrl / Cmd + Shift + P and enter Dev Containers: Rebuild Container and Reopen in Container
  4. A new VS Code window will open and begin building the Docker image. It will take several minutes to build the first time.
  5. Once the image is finished building, press Ctrl / Cmd + Shift + P and enter CodeRoad: Start to open CodeRoad
  6. In the CodeRoad window, click "Start New Tutorial"
  7. Enter the URL to the tutorial.json file of the project you want to start (ex: https://raw.githubusercontent.com/freeCodeCamp/learn-bash-by-building-a-boilerplate/main/tutorial.json)
  8. Click the "Start" button

There may be some additional troubleshooting steps to get the container running properly. They can often be solved by following the onscreen instructions, or examining any error messages in your terminal.

How to Restart or Switch Projects

Note: If you restart or switch projects you will lose your progress, along with any files or directories you created.

  1. Press Ctrl / Cmd + Shift + P and enter Dev Containers: Rebuild Container
  2. Wait for VS Code to reopen and reload the Docker container
  3. Open CodeRoad, enter the URL to a tutorial.json file, and start the project as described above

tutorial.json File URLs for CodeRoad