deprec 3.1.0.rc2 → 3.1.0.rc3

data/COPYING

@@ -1,4 +1,4 @@
-Copyright (c) 2006-2008 Mike Bailey <mike.bailey.net.au>
+Copyright (c) 2006-2011 Mike Bailey <mike.bailey.net.au>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to

data/docs/GETTING_STARTED

@@ -0,0 +1,83 @@
+== Installation and initial server setup for deprec2
+
+Install deprec with the following command (requires ruby and rubygems installed)
+
+	sudo gem install deprec
+
+Let's create a directory to manage all our host config details 
+This supports as many hosts as you need to manage and will be the dir
+you run your deprec commands from when managing the servers. Note that
+you don't need to do this if you just want to deploy a single Ruby on 
+Rails application. In this case the config/ dir in your project can
+serve the same purpose. For those who aren't interested in Ruby on Rails
+or want to use deprec for more than just deploying one rails app, the 
+following may come in handy.
+
+	mkdir -p sys/config		  # change 'sys' to whatever you want
+	cd sys					  # 
+	depify .				  # create Capfile and config/deploy.rb
+	cap deprec:ssh:config_gen # generates ssh server configs
+
+If you have an authorized_keys file, copy it to a location where deprec
+can find it. We name these files using the username of their owner.
+
+	cp ~/.ssh/authorized_keys config/ssh/authorized_keys/${USER}
+	
+Deprec will then offer to copy it out to remote hosts when
+you setup new accounts for yourself. If you don't have authorized_keys,
+copy out your id_rsa.pub or id_dsa.pub file. You can also put the 
+authorized_keys of colleagues in this dir and deprec will offer to 
+copy them out when creating accounts for them too.
+
+Change the root password you received for your new slice.
+
+	cap deprec:users:passwd USER=root HOSTS=<your.slice.address>
+
+		Enter user to change password for  |root|
+		Password: 
+		Enter new UNIX password: 
+		Retype new UNIX password: 
+
+
+Create an account with sudo access for myself:
+
+	cap deprec:users:add USER=root 
+
+		Enter userid for new user  |root|
+		mbailey
+		Should this be an admin account?  |no|
+		yes
+		I've found an authorized_keys file for mbailey. Should I copy it out?  |yes|
+		Password: 
+		Setting pasword for new account
+		Enter new UNIX password: 
+		Retype new UNIX password: 
+
+
+Create another account without sudo access for a colleague.
+Notice how I longer need to specify USER=root? That's because I'm using the 
+account I just created (mbailey).
+
+	cap deprec:users:add
+
+		Enter userid for new user  |mbailey|
+		ben
+		Should this be an admin account?  |no|
+		Password: 
+		Setting pasword for new account
+		Enter new UNIX password: 
+		Retype new UNIX password: 
+ 
+I prefer to disallow ssh password based login for security reasons. I also 
+turn off DNS lookups by sshd as they are often responsible for a 2 second 
+lag on login. Be warned that turning off ssh passwords will prevent someone 
+without an ssh key setup from logging in so use this with caution. Deprec 
+makes it painless to upload their key when you create their account though 
+so you've got no excuse to leave passwords turned on.
+
+You can upload the ssh configs currently residing in config/ssh/etc/ssh by 
+running this:
+
+	cap deprec:ssh:config
+
+You can now continue to the other READMEs

data/docs/TODO.txt

@@ -0,0 +1,12 @@
+deprec/TODO.txt
+===============
+
+* new wordpress
+* get rid of run_method - s/send(run_method, "/run "#{sudo} /
+* clean out stale tasks (from cap -T)
+
+# Add option to symlink apache vhosts
+#
+# This will make updating with deploys easier
+#
+ln -sf /srv/brandish/current/config/uat/passenger/apache_vhost brandish

data/lib/deprec/cap/callbacks/asset_pipeline.rb

@@ -2,67 +2,68 @@
 #
 # Capistrano::Configuration.instance(:must_exist).load do
 # require 'capistrano/recipes/deploy'
+Capistrano::Configuration.instance(:must_exist).load do
 
-def _cset(name, *args, &block)
-  unless exists?(name)
-    set(name, *args, &block)
+  def _cset(name, *args, &block)
+    unless exists?(name)
+      set(name, *args, &block)
+    end
   end
-end
 
-_cset :asset_env, "RAILS_GROUPS=assets"
-_cset :rails_env, "production"
+  _cset :asset_env, "RAILS_GROUPS=assets"
+  _cset :rails_env, "production"
 
-# rails-3.1 does not use asset timestamps
-set :normalize_asset_timestamps, false
+  # rails-3.1 does not use asset timestamps
+  set :normalize_asset_timestamps, false
 
-after 'deploy:update_code', 'deploy:assets:symlink'
-after 'deploy:update_code', 'deploy:assets:precompile'
+  after 'deploy:update_code', 'deploy:assets:symlink'
+  after 'deploy:update_code', 'deploy:assets:precompile'
 
-namespace :deploy do
-  namespace :assets do
-    desc <<-DESC
-      [internal] This task will set up a symlink to the shared directory \
-      for the assets directory. Assets are shared across deploys to avoid \
-      mid-deploy mismatches between old application html asking for assets \
-      and getting a 404 file not found error.
-    DESC
-    task :symlink, :roles => :web, :except => { :no_release => true } do
-      run <<-CMD
-        rm -rf #{latest_release}/public/assets &&
-        mkdir -p #{latest_release}/public &&
-        mkdir -p #{shared_path}/assets &&
-        ln -s #{shared_path}/assets #{latest_release}/public/assets
-      CMD
-    end
+  namespace :deploy do
+    namespace :assets do
+      desc <<-DESC
+        [internal] This task will set up a symlink to the shared directory \
+        for the assets directory. Assets are shared across deploys to avoid \
+        mid-deploy mismatches between old application html asking for assets \
+        and getting a 404 file not found error.
+      DESC
+      task :symlink, :roles => :web, :except => { :no_release => true } do
+        run <<-CMD
+          rm -rf #{latest_release}/public/assets &&
+          mkdir -p #{latest_release}/public &&
+          mkdir -p #{shared_path}/assets &&
+          ln -s #{shared_path}/assets #{latest_release}/public/assets
+        CMD
+      end
 
-    desc <<-DESC
-      Run the asset precompilation rake task. You can specify the full path \
-      to the rake executable by setting the rake variable. You can also \
-      specify additional environment variables to pass to rake via the \
-      asset_env variable. The defaults are:
+      desc <<-DESC
+        Run the asset precompilation rake task. You can specify the full path \
+        to the rake executable by setting the rake variable. You can also \
+        specify additional environment variables to pass to rake via the \
+        asset_env variable. The defaults are:
 
-        set :rake,      "rake"
-        set :rails_env, "production"
-        set :asset_env, "RAILS_GROUPS=assets"
-    DESC
-    task :precompile, :roles => :web, :except => { :no_release => true } do
-      run "cd #{latest_release} && #{rake} RAILS_ENV=#{rails_env} #{asset_env} assets:precompile"
-    end
+          set :rake,      "rake"
+          set :rails_env, "production"
+          set :asset_env, "RAILS_GROUPS=assets"
+      DESC
+      task :precompile, :roles => :web, :except => { :no_release => true } do
+        run "cd #{latest_release} && #{rake} RAILS_ENV=#{rails_env} #{asset_env} assets:precompile"
+      end
 
-    desc <<-DESC
-      Run the asset clean rake task. Use with caution, this will delete \
-      all of your compiled assets. You can specify the full path \
-      to the rake executable by setting the rake variable. You can also \
-      specify additional environment variables to pass to rake via the \
-      asset_env variable. The defaults are:
+      desc <<-DESC
+        Run the asset clean rake task. Use with caution, this will delete \
+        all of your compiled assets. You can specify the full path \
+        to the rake executable by setting the rake variable. You can also \
+        specify additional environment variables to pass to rake via the \
+        asset_env variable. The defaults are:
 
-        set :rake,      "rake"
-        set :rails_env, "production"
-        set :asset_env, "RAILS_GROUPS=assets"
-    DESC
-    task :clean, :roles => :web, :except => { :no_release => true } do
-      run "cd #{latest_release} && #{rake} RAILS_ENV=#{rails_env} #{asset_env} assets:clean"
+          set :rake,      "rake"
+          set :rails_env, "production"
+          set :asset_env, "RAILS_GROUPS=assets"
+      DESC
+      task :clean, :roles => :web, :except => { :no_release => true } do
+        run "cd #{latest_release} && #{rake} RAILS_ENV=#{rails_env} #{asset_env} assets:clean"
+      end
     end
   end
 end
-end

data/lib/deprec/version.rb

@@ -1,3 +1,3 @@
 module Deprec
-  VERSION = "3.1.0.rc2"
+  VERSION = "3.1.0.rc3"
 end

metadata

@@ -2,7 +2,7 @@
 name: deprec
 version: !ruby/object:Gem::Version 
   prerelease: 6
-  version: 3.1.0.rc2
+  version: 3.1.0.rc3
 platform: ruby
 authors: 
 - Mike Bailey
@@ -56,9 +56,11 @@ extra_rdoc_files: []
 files: 
 - bin/hosts.rb
 - bin/depify
+- docs/TODO.txt
 - docs/README.rails
 - docs/config_gen_explained.txt
 - docs/old/deprec_banner.gif
+- docs/GETTING_STARTED
 - docs/deprec_cmd_completion.sh
 - docs/deprec-1.x/deprec-1.x.quickstart
 - docs/deprec-1.x/notes.txt