Please join the chat on Gitter. We want as much feedback as possible!
Read the Docs or help improve the docs.
Issues and Story Boarding
As a symfony app, we are following PSR-2 Coding Standards.
Use 4 spaces for indentation, and follow all the other rules specified at http://www.php-fig.org/psr/psr-2/
NuCivic submitted a working prototype for the 18F Agile BPA.
We used Terra as the recommended method for recreating the site on another server.
See the instructions on setting up http://openfda.nucivic.build on another server using Terra.
The "Terra Server" project serves as a web based interface for Terra. It is built on Drupal 8.
See the terra-server GitHub repo for more information.
Terra is the spiritual successor to Aegir & DevShop, the Drupal site hosting platforms. It came from the idea that we could benefit from starting over.
The feeling was that with modern libraries like symfony, ansible, and docker we would be able to do a lot quickly, and, well I've been able to do a lot, pretty quickly.
Now I am on a mission to call everyone to action to work behind a common tool for us all.
To make having a website as easy as possible throughout it's entire lifetime, from localhost through large scale production, through entirely open source software.
Terra is a human interface for working on, deploying, testing, and scaling web software projects.
Terra makes it quick and painless to manage your projects and environments.
Push a button to get a testing infrastructure.
An "App" is your website. It is the source code for your project. Terra knows the git URL and (will) know the available branches and tags. Terra will help you update your app from it's upstream repository using git.
The Environment is all of the systems needed to run the source code.
The "EnvironmentFactory" class will be pluggable. Out of the box it provides a working docker cluster, but we can extend it to work with a "multiple apache vhost" model or with a different container provider.
Users will be able to use terra to control environments hosted by multiple hosting providers, including localhost all through the same interface.
We wish to make this tool work for everyone. We wish to get feedback from all parties interested in solving these problems in order to prioritize what to work on.
Please join us in the Issue Queues on GitHub and the chat rooms on gitter.
We wanted to start from scalable. Terra's purpose is to make scaling a push button affair.
Currently Terra uses Docker and Docker compose to stand up and scale websites.
This makes it easy to get environments running quickly on hosted servers or on local computers for development.
See https://huboard.com/terra-ops/terra-app/ for the user story board.
I am going to direct planning in an agile way as much as possible. Please post as much feedback as you can in the issue queues.
- docker
- docker-compose
List all apps on this system.
Add a new app to the system.
Currently only Drupal sites are supported.
Remove an app from the system
Add an environment for an app.
Remove an environment.
Runs docker-compose up
to initiate an environment.
Provides status information about an environment, including path and URL.
Set the number of "app" containers. This command is a wrapper for docker compose app=5
.
There is a Vagrantfile in the repo that can be used to fire up a linux server with Terra installed.
Use the vagrant plugin "vagrant-hostsupdater" to automatically set your /etc/hosts file for the VM:
$ vagrant plugin install vagrant-hostsupdater
Some of the R&D for Terra happened in a project called "director": https://github.com/jonpugh/director-drupal
Director is now deprecated.
There is a striking similarity to this project and Kalabox.
We love Kalabox and the Kalamuna team, but there are a few key differences:
- Terra is designed for all things: local development, testing, and production.
- Terra is written in PHP & Symfony: Kalabox is written in Node JS
- Terra is a proposed platform to power the future of Aegir & devshop. We hope to recruit a large community from those tools.
- Terra currently extends the kalabox/drush container to offer a container to SSH into.
We hope to collaborate with them on as much as possible.