capifony 0.1.0

data/CHANGELOG

@@ -0,0 +1,3 @@
+== 0.1.0 / June 3, 2010
+
+First ever working version.

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2010 Konstantin Kudryashov <ever.zet@gmail.com>
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,88 @@
+Deploying symfony Applications with Capistrano
+----------------------------------------------
+
+Capistrano is an open source tool for running scripts on multiple servers. It’s primary use is for easily deploying applications. While it was built specifically for deploying Rails apps, it’s pretty simple to customize it to deploy other types of applications. We’ve been working on creating a deployment “recipe” to work with symfony applications to make our job a lot easier.
+
+### Prerequisites ###
+
+- Must have SSH access to the server you are deploying to.
+- Must have Ruby and RubyGems installed on your machine (not required for deployment server)’
+
+### Installing Capifony ###
+
+	sudo gem install capifony
+
+### Setup your project to use Capifony ###
+
+CD to your project directory & run:
+
+	capifony .
+
+This will create `Capfile` in your project root & `deploy.rb` config file in `config` directory
+
+Fill up your `config/deploy.rb` with your server connection data
+
+### Server Setup ###
+
+Now, you can start the deployment process! To get your server setup with the file structure that Capistrano expects, you can run:
+
+	cap deploy:setup
+
+This command will create the following folder structure on your server:
+
+	|-- deploy_to_path
+	  |-- current (symlink)
+	  |-- releases
+	    |-- 20100512131539
+	    |-- 20100509150741
+	    |-- 20100509145325
+	  |-- shared
+	    |-- log
+	    |-- web
+	      |-- uploads
+
+The folders in the releases directory will be the actual deployed code, timestamped. Capistrano symlinks your log & web/uploads directories from your app to the directories in the shared folder so that it doesn’t get erased when you deploy a new version of your code.
+
+To deploy your application, simply run:
+
+	cap deploy
+
+To configure database on production environment, run:
+
+	cap symfony:configure:database
+
+To deploy your application for the first time, you can run:
+
+	cap deploy:cold
+
+This will deploy your application, configures databases.yml (will ask you about DSN, user, pass), create the db, models, forms, filters, and run all of your migrations.
+
+Now, whenever you need to deploy a new version of your code, just run:
+
+	cap deploy
+
+If you need to deploy and run your migrations you can call:
+
+	cap deploy:migrations
+
+We’ve also added a custom task to run your test suite on the production server. You can invoke this by calling:
+
+	cap deploy:tests:all
+
+This will deploy the application, rebuild the test database, then run all of the tests.
+
+Also, you have command to run your custom symfony tasks:
+
+	cap symfony:run_task
+
+If you want to see all of the Capistrano tasks available, you can run:
+
+	cap -T
+
+We’ve been using this setup for a little while now, and it’s saved us a ton of time when we need to push changes for a site to the production server.
+
+Contributors
+============
+
+* everzet (owner): [http://github.com/everzet](http://github.com/everzet)
+* Travis Roberts (creator of improved version): [http://blog.centresource.com/author/troberts/](http://blog.centresource.com/author/troberts/)

data/bin/capifony

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'fileutils'
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{File.basename($0)} [path]"
+
+  opts.on("-h", "--help", "Displays this help info") do
+    puts opts
+    exit 0
+  end
+
+  begin
+    opts.parse!(ARGV)
+  rescue OptionParser::ParseError => e
+    warn e.message
+    puts opts
+    exit 1
+  end
+end
+
+if ARGV.empty?
+  abort "Please specify the directory to capifony, e.g. `#{File.basename($0)} .'"
+elsif !File.exists?(ARGV.first)
+  abort "`#{ARGV.first}' does not exist."
+elsif !File.directory?(ARGV.first)
+  abort "`#{ARGV.first}' is not a directory."
+elsif ARGV.length > 1
+  abort "Too many arguments; please specify only the directory to capifony."
+end
+
+def unindent(string)
+  indentation = string[/\A\s*/]
+  string.strip.gsub(/^#{indentation}/, "")
+end
+
+files = {
+  "Capfile" => unindent(<<-FILE),
+    load 'deploy' if respond_to?(:namespace) # cap2 differentiator
+    Dir['vendor/plugins/*/recipes/*.rb'].each { |plugin| load(plugin) }
+    load Gem.required_location('capifony', 'capifony.rb')
+    load 'config/deploy' # remove this line to skip loading any of the default tasks
+  FILE
+
+  "config/deploy.rb" => 'set :application, "set your application name here"
+set :domain,      "#{application}.com"
+set :deploy_to,   "/path/to/www/#{domain}"
+
+set :repository,  "#{domain}:/reps/#{application}.git"
+set :scm,         :git
+# Or: `accurev`, `bzr`, `cvs`, `darcs`, `subversion`, `mercurial`, `perforce`, `subversion` or `none`
+
+role :web,        domain                         # Your HTTP server, Apache/etc
+role :app,        domain                         # This may be the same as your `Web` server
+role :db,         domain, :primary => true       # This is where Rails migrations will run
+
+set  :keep_releases,  3'}
+
+base = ARGV.shift
+files.each do |file, content|
+  file = File.join(base, file)
+  if File.exists?(file)
+    warn "[skip] '#{file}' already exists"
+  elsif File.exists?(file.downcase)
+    warn "[skip] '#{file.downcase}' exists, which could conflict with `#{file}'"
+  else
+    unless File.exists?(File.dirname(file))
+      puts "[add] making directory '#{File.dirname(file)}'"
+      FileUtils.mkdir(File.dirname(file))
+    end
+    puts "[add] writing '#{file}'"
+    File.open(file, "w") { |f| f.write(content) }
+  end
+end
+
+puts "[done] capifonied!"

data/lib/capifony.rb

@@ -0,0 +1,178 @@
+# Dirs that need to remain the same between deploys (shared dirs)
+set :shared_children, %w(log web/uploads)
+
+def prompt_with_default(var, default)
+  set(var) do
+    Capistrano::CLI.ui.ask "#{var} [#{default}] : "
+  end
+  set var, default if eval("#{var.to_s}.empty?")
+end
+
+namespace :deploy do
+  desc "Overwrite the start task to set the permissions on the project."
+  task :start do
+    symfony.configure.database
+    symfony.project.permissions
+    doctrine.build_all_and_load
+  end
+
+  desc "Overwrite the restart task because symfony doesn't need it."
+  task :restart do ; end
+
+  desc "Overwrite the stop task because symfony doesn't need it."
+  task :stop do ; end
+
+  desc "Customize migrate task because symfony doesn't need it."
+  task :migrate do
+    doctrine.migrate
+  end
+
+  desc "Symlink static directories that need to remain between deployments."
+  task :create_dirs do
+    if shared_children
+      shared_children.each do |link|
+        run "mkdir -p #{shared_path}/#{link}"
+        run "ln -nfs #{shared_path}/#{link} #{release_path}/#{link}"
+      end
+    end
+
+    run "touch #{shared_path}/databases.yml"
+  end
+
+  desc "Customize the finalize_update task to work with symfony."
+  task :finalize_update, :except => { :no_release => true } do
+    run "chmod -R g+w #{latest_release}" if fetch(:group_writable, true)
+    run "mkdir -p #{latest_release}/cache"
+    create_dirs
+
+    if fetch(:normalize_asset_timestamps, true)
+      stamp = Time.now.utc.strftime("%Y%m%d%H%M.%S")
+      asset_paths = %w(css images js).map { |p| "#{latest_release}/web/#{p}" }.join(" ")
+      run "find #{asset_paths} -exec touch -t #{stamp} {} ';'; true", :env => { "TZ" => "UTC" }
+    end
+  end
+
+  desc "Need to overwrite the deploy:cold task so it doesn't try to run the migrations."
+  task :cold do
+    update
+    start
+  end
+
+  desc "Deploy the application and run the test suite."
+  task :testall do
+    update_code
+    symlink
+    doctrine.build_all_and_load_test
+    symfony.tests.all
+  end
+end
+
+namespace :symlink do
+  desc "Symlink the database"
+  task :db do
+    run "ln -nfs #{shared_path}/databases.yml #{latest_release}/config/databases.yml"
+  end
+end
+
+namespace :symfony do
+  desc "Clears the cache"
+  task :cc do
+    run "php #{latest_release}/symfony cache:clear"
+  end
+
+  desc "Runs custom symfony task"
+  task :run_task do
+    prompt_with_default(:task_arguments, "cache:clear")
+
+    run "php #{latest_release}/symfony #{task_arguments}"
+  end
+
+  namespace :configure do
+    desc "Configure database DSN"
+    task :database do
+      prompt_with_default(:dsn, "mysql:host=localhost;dbname=example_dev")
+      prompt_with_default(:user, "root")
+      prompt_with_default(:pass, "")
+      dbclass = "sfDoctrineDatabase"
+
+      run "php #{latest_release}/symfony configure:database --class=#{dbclass} '#{dsn}' '#{user}' '#{pass}'"
+    end
+  end
+
+  namespace :project do
+    desc "Fixes symfony directory permissions"
+    task :permissions do
+      run "php #{latest_release}/symfony project:permissions"
+    end
+
+    desc "Optimizes a project for better performance"
+    task :optimize do
+      prompt_with_default(:application, "frontend")
+
+      run "php #{latest_release}/symfony project:optimize #{application}"
+    end
+
+    desc "Clears all non production environment controllers"
+    task :clear_controllers do
+      run "php #{latest_release}/symfony project:clear-controllers"
+    end
+  end
+
+  namespace :plugin do
+    desc "Publishes web assets for all plugins"
+    task :publish_assets do
+      run "php #{latest_release}/symfony plugin:publish-assets"
+    end
+  end
+
+  namespace :log do
+    desc "Clears log files"
+    task :clear do
+      run "php #{latest_release}/symfony log:clear"
+    end
+
+    desc "Rotates an application's log files"
+    task :rotate do
+      prompt_with_default(:application, "frontend")
+      prompt_with_default(:env, "prod")
+
+      run "php #{latest_release}/symfony log:rotate #{application} #{env}"
+    end
+  end
+
+  namespace :tests do
+    desc "Task to run all the tests for the application."
+    task :all do
+      run "php #{latest_release}/symfony test:all"
+    end
+  end
+end
+
+namespace :doctrine do
+  desc "Migrates database to current version"
+  task :migrate do
+    run "php #{latest_release}/symfony doctrine:migrate --env=prod"
+  end
+
+  desc "Generate code & database based on your schema"
+  task :build_all do
+    run "php #{latest_release}/symfony doctrine:build --all --no-confirmation --env=prod"
+  end
+
+  desc "Generate code & database based on your schema & load fixtures"
+  task :build_all_and_load do
+    run "php #{latest_release}/symfony doctrine:build --all --and-load --no-confirmation --env=prod"
+  end
+
+  desc "Generate code & database based on your schema & load fixtures for test environment"
+  task :build_all_and_load_test do
+    run "php #{latest_release}/symfony doctrine:build --all --and-load --no-confirmation --env=test"
+  end
+end
+
+after "deploy:finalize_update", # After finalizing update:
+  "symlink:db",                       # 1. Symlink database
+  "symfony:cc",                       # 2. Clear cache
+  "symfony:plugin:publish_assets",    # 3. Publish plugin assets
+  "symfony:project:permissions"       # 4. Fix project permissions
+  "symfony:project:clear_controllers" # 5. Clear controllers

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: capifony
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Konstantin Kudryashov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-03 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 5
+        - 10
+        version: 2.5.10
+  type: :runtime
+  version_requirements: *id001
+description: "    Capistrano is an open source tool for running scripts on multiple servers. It\xE2\x80\x99s primary use is for easily deploying applications. While it was built specifically for deploying Rails apps, it\xE2\x80\x99s pretty simple to customize it to deploy other types of applications. This package is a deployment \xE2\x80\x9Crecipe\xE2\x80\x9D to work with symfony PHP applications.\n"
+email: ever.zet@gmail.com
+executables: 
+- capifony
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/capifony
+- lib/capifony.rb
+- README
+- LICENSE
+- CHANGELOG
+has_rdoc: false
+homepage: http://everzet.com/projects/symfony-helpers/capifony
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: capifony
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Deploying symfony PHP applications with Capistrano.
+test_files: []
+