Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Configuration Generator
Ruby
Branch: master

ugh

latest commit 9ac5b81375
@jnicklas authored
Failed to load latest commit information.
bin initial checkin
lib
spec fixed some stuff
templates mmm, maybe?
LICENSE updated some stuff
README
Rakefile ugh
TODO initial checkin

README

Confiture
=========

Generate config files for your applications. Start with an easy to edit yml file and have confiture generate for example Apache or God config files for you.

    git clone git://github.com/jnicklas/confiture.git 
    cd confiture
    rake package
    sudo gem install pkg/confiture*

You should generate your personal stub of templates, these can then be adapted to fit your needs

    confiture init
    
Edit the /etc/confiture/config.yml file, and point it to where you want your config files to be located.

Confiture will by default look for config files in:

    /var/app/you_app_name/app.yml
    
so create an app.yml file in that directory. The syntax for this file is documented below. You might want to symlink it from your app if you use capistrano:

    ln -s /var/app/your_app_name/current/config/deploy.yml /var/app/your_app_name/app.yml
    
You can now use confiture to update you configuration files:

    confiture your_app_name

or if you only want to update selected config files:

    confiture your_app_name apache
    confiture your_app_name god

if the config files already exist, confiture will ask you what you want to do, if you are using confiture non-interactively (via capistrano for example) you might want to specify the -f option to override files without asking:

    confiture your_app_name -f


Config File Syntax
------------------

Config files are in YAML format, and the syntax is compatible with those used by mongrel_cluster, so you can actually point your mongrel cluster at this file and run it as the configuration:

    name: tensor
    kind: rails

    cwd: /var/rails/tensor/current

    address: 127.0.0.1

    port: 8001
    servers: 3

    environment: production
    pid_file: log/mongrel.pid

    host:
      name: default
      port: 80
      domain: tensor.se
      aliases:
        - www.tensor.se

Name is a required parameter, kind is assumed to be 'rails' when not set. Multiple hosts can be specified like this:

    name: tensor
    kind: rails

    cwd: /var/rails/tensor/current

    address: 127.0.0.1

    port: 8001
    servers: 3

    environment: production
    pid_file: log/mongrel.pid

    hosts:
      -
        name: default
        port: 80
        domain: tensor.se
        aliases:
          - www.tensor.se
      -
        name: secure
        type: https
        host: 192.45.34.12
        port: 443
        domain: secure.tensor.se
        aliases:
          - blah.tensor.se
          - dorr.tensor.se
          - gurr.tensor.se
Something went wrong with that request. Please try again.