Getting Started
Quick Guides
Using Bunnyshell
Creating and Deploying your first Environment
Introduction
Bunnyshell makes it easy for you to create full-stack environments, going from simple static websites to some of the most complex applications.
Before you get started
An Environment is a user-defined group that brings together applications and all of the services and databases those applications require, running within a namespace.
Environments typically represent the software project lifecycle stages, such as staging, development, QA, or production.
Prerequisites
Follow the instructions below to deploy your own environment.
1. Creating an environment
Select a Project from the main Bunnyshell interface and click Create environment. Give it a name that is easily recognizable by anyone in your team and click Create environment.
2. Defining your Environment Components
Once the environment has been created, it's time to define the environment components and configuration. To add an application in the environment click on Create application in the environment view.
Application Repository
Select a repository from your VCS that you'd like to use to create your application. If you haven't yet connected your Git provider, you can do it now.
Review Environment Components
When a repository is selected, Bunnyshell will analyze the specified branch on that repo to find all the applications and their required dependencies (services and databases). This information is gathered from either
docker-compose.yaml or package.json .Review all of the detected services to ensure they are correct. If you are missing a service, review your
docker-compose.yaml or package.json file. If this looks correct, you can click Continue.
Environment configuration validation
In this step, you can review and, if necessary, modify the Environment definition file. Click Create application after reviewing or editing.
The
env.yaml file is a single editable record, representing the entire environment definition, including Applications / Services / Databases.
Your primary environment is now defined and ready to be deployed.
3. Deploying your environment
- 1.In the Actions menu, click Deploy. The Select cluster window is displayed.
- 2.Select the Kubernetes cluster where you want to deploy the environment and click Deploy Environment. Congratulations! Bunnyshell deployed the environment and now your application is live and testable by everybody within your team.
In case you encounter errors after deploying your environment, access the logs for more information regarding potential issues. Find out more about debugging environments here.