Default Caracal site with predefined Vagrantfile for easy start.
The following steps need to be executed in order to get a new fully functional development environment for Caracal-based site:
- Create a new empty repository on GitHub. This is where we will keep site-specific files, so name it according to site. For the sake of tutorial we'll call it
New-Site; - Clone new repository to your local machine under
New-Sitename by issuing the following command:
git clone git@github.com:You/New-Site.git New-Site
- Go in to
New-Sitedirectory; - We need to add Caracal-Site as
upstreamso Git knows where to pull things from. You do that with following command:
git remote add upstream https://github.com/Way2CU/Caracal-Site.git
- We need to get
upstreamdata. To do that issue the following command;
git pull upstream master
- Our new repository is ready, we can now push changes to GitHub:
git push origin --all
We use Vagrant to set up our environment. Once preparation is done you will have couple of files in your New-Site directory. These files should not be changed. While in New-Site directory issue the following command:
vagrant up
This should download, prepare and configure development environment for New-Site. This preparation can take a while depending on your network speed. Once preparation is done, additional files will appear in your directory. You can now start working on your new project.
Suspending virtual environment is done with vagrant suspend and resumed with vagrant resume. Once development is completed virtual environment can be destroyed with vagrant destroy without affecting site files.