You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

48 lines
1.8 KiB

# Magallanes #
### What's Magallanes? ###
13 years ago
Magallanes is a deployment tool for PHP applications; it's quite simple to use and manage.
13 years ago
It will get your application to a safe harbor.
13 years ago
13 years ago
### So, What can it do? ###
13 years ago
You can instruct Magallanes to deploy your code to all the servers you want (via rsync over ssh),
13 years ago
and run tasks for that freshly deployed code.
13 years ago
### Can you give me some examples/ideas? ###
13 years ago
**Sure!**
Suppose you have a checkout of your app and you have to deploy it to four servers;
and after each deploy you have to run some boring tasks, like fixing file permissions, creating symlinks, etc.
You can define all this on Magallanes and with *just one command* you can do all this at once!
13 years ago
Like this:
```
13 years ago
$ mage deploy to:production
```
13 years ago
### What's this sorcery?! ###
13 years ago
Easy boy. It's not sorcery, just some *technomagick*!
13 years ago
13 years ago
In Magallanes you define environments like *testing*, *staging*, or *production* like on the example above.
13 years ago
Then, on that environment, you can configure a setup specifing to which hosts you want to deploy and what tasks to run (*after*, *on*, and *before* deploying).
And you are done!
13 years ago
13 years ago
### And what spells... tasks! What tasks has it built in? ###
13 years ago
Just a few, for now...
13 years ago
13 years ago
- **deployment/rsync** - This task is for deploying your code to the remote servers.
- **scm/update** - This task is for updating (git/svn) your base wokring copy.
13 years ago
But that's not all! You can create your own taks, and execute commands on your working copy and in your deployed code!
Also we are working on creating more built in tasks.
13 years ago
### This is awesome! Where can I learn more? ###
You can read the whole source code (naaah!); or checkout the wiki at: http://magallanes.zenreworks.com/wiki
13 years ago
Enjoy your magic trip with **Magallanes** to the land of the easily deployable apps!!