This is starter project for Laravel development using Visual Studio Code's Remote Container development.
This project is intended to need minimal environment setup. Meaning the host machine doesn't need get a developer started. Any software needed by the developer will be installed in the container, including VSCode extensions.
- Visual Studio Code with Remote - Containers extension installed.
- Docker Desktop
Optional
- Git for pulling this repository
- SSH for pushing this repository via Git
To start using this project, following these steps:
- Clone this repository to your system.
- Open the project folder in VSCode.
- In VSCode press
command+shift+pand type "Open in Container" and pressenter.
The project containers will build and you will be up and running in a jiffy.
VSCode has an extension call "Remote - Containers" that allows a user to open their workspace within a Docker container. Once inside the container all VSCode will treat the container environment as if it is the host machine. This means extensions like Git, terminal, etc. all run in the container, rather than the host.
To configure the "Remote - Containers" extension we use a .devcontainer.json file that defines how to run the containers (docker-compose), the container to load as the workspace, VSCode settings and extensions specific to the project. For more information on configuring this extension read the article Developing inside a Container.