Define the Environment

Let's add an application by clicking on Define environment in the environment view.

1. Select your Git account and the forked Bunnyshell Books repository.

2. Use master as branch, and leave the docker-compose file path to / (the default value), as it is located in the root of the repository.

3. Hit Continue. A few seconds will be needed to parse and validate docker-compose.yaml.

The following elements from the docker-compose.yaml file are detected :

• The Services: frontend, backend, db
• Their exposed ports
• How the services will be built (Dockerfiles, build arguments)
• Needed persistent volumes
• Default values for environment variables

📘

Note

Bunnyshell uses all this information to build the Environment Definition, also named bunnyshell.yaml.

🚧

You will use this YAML definition moving forward, when modifying or adding services, or use the UI.

The docker-compose.yaml file is only read by Bunnyshell when constructing the initial Environment Definition. Subsequent updates in the file will not be propagated into the environment automatically.

4. Finally, click Create Application and you're done. A few seconds will be needed to validate the configuration.

👍

Note

You can always add more Applications from other docker-compose.yaml files, from the UI.

Sensible defaults for Bunnyshell

The reason for which this Application does not require any changes at all is that we've made some minor preparations: we've included a separate .env file within the repository and named it .env.bunnyshell.

This way, you can keep the .env and .env.sample for development purposes and not interfere with your current process, while at the same time having some default values for Bunnyshell.

👍

Pro Tip

Use .env.bunnyshell for setting Environment Variables for Bunnyshell.