meskyanichi-generators 0.1.0 → 0.1.1
Sign up to get free protection for your applications and to get access to all the features.
- data/README.rdoc +28 -26
- data/Rakefile +2 -1
- data/VERSION.yml +1 -1
- metadata +12 -3
data/README.rdoc
CHANGED
@@ -9,49 +9,51 @@ For now the gem only provides a generator for a simple capistrano template.
|
|
9
9
|
|
10
10
|
Essentially what this does, is generate a basic Capistrano deployment recipe. The recipe does a couple of things initially when you set it up.
|
11
11
|
|
12
|
-
|
13
|
-
|
14
|
-
|
12
|
+
Create the necessary folders and files, namely the releases, current(symlink) and the shared folder
|
13
|
+
Creates a log folder and generates a new production.log
|
14
|
+
Creates a config folder and then syncs the database.yml from your Rails application to the remote server
|
15
15
|
|
16
16
|
During every deployment, the recipe will:
|
17
17
|
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
18
|
+
Update your remote repository before deployment to ensure all files are up to date
|
19
|
+
After deployment, will restart the application for Passenger
|
20
|
+
After deployment, will place the symlinks for the database and production.log files correctly
|
21
|
+
Make the javascripts and stylesheets directory, located in the RAILS_ROOT/public directory,
|
22
|
+
writable to avoid script caching errors
|
22
23
|
|
23
24
|
If you wish to generate the simple Capistrano Template, open the terminal, go to the root of your rails application and type the following:
|
24
25
|
|
25
|
-
|
26
|
+
script/generate capistrano_template
|
26
27
|
|
27
28
|
This will generate the capistrano template which you help you get up and running.
|
28
29
|
|
29
30
|
You can also pass in additional arguments to let the generator help you fill in Capistrano recipe.
|
30
31
|
|
31
|
-
|
32
|
+
script/generate capistrano_template MyDomain.com
|
33
|
+
git ssh://MyDomain.com/MyRepository.git master root /var/www/vhosts/MyDomain.com/httpdocs
|
32
34
|
|
33
35
|
If you fill in the above correctly, (this also depends on your server setup / OS / etc), then it should work right out of the box.
|
34
36
|
|
35
37
|
Below are the arguments which you can provide, in order:
|
36
38
|
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
39
|
+
domain_name (e.g. MyDomain.com)
|
40
|
+
scm (e.g. git)
|
41
|
+
repository (e.g. ssh://MyDomain.com/MyRepository.git)
|
42
|
+
branch (e.g. master)
|
43
|
+
user (e.g. root)
|
44
|
+
deploy_to (e.g. /var/www/vhosts/MyDomain.com/httpdocs)
|
43
45
|
|
44
46
|
This generates the deploy.rb file with the specified settings in the RAILS_ROOT/config directory.
|
45
47
|
|
46
48
|
Now the whole process in steps:
|
47
49
|
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
50
|
+
1: sudo gem install meskyanichi-generators
|
51
|
+
2: go to root of rails app and type "capify ."
|
52
|
+
3: then type "script/generate capistrano_template [arg1..arg6]"
|
53
|
+
4: when it prompts if you wish to overwrite, type "y" and hit return
|
54
|
+
5: now type "cap deploy:setup" to set up the whole directory structure and files
|
55
|
+
6: after the setup is finished, and assuming you have your local git repository set up correctly,
|
56
|
+
type "cap deploy" and your application will go live in a matter of seconds!
|
55
57
|
|
56
58
|
If you did not fill in all the arguments, or wish double check if it was all set up correctly, open the
|
57
59
|
deploy.rb file located in the config directory and have a look. You can easily modify everything to your liking as well!
|
@@ -62,21 +64,21 @@ deploy.rb file located in the config directory and have a look. You can easily m
|
|
62
64
|
The recipe provides a few commands which are pretty useful. Including syncing your local database.yml file
|
63
65
|
with the one on the server so that you are not forced to go SSH or FTP to the server to manually change it.
|
64
66
|
|
65
|
-
|
67
|
+
cap deploy:sync_database
|
66
68
|
|
67
69
|
If you wish to restart your application for Passenger without re-deploying your application, for example, after syncing the new database.yml,
|
68
70
|
and you once again don't want to SHH manually, then you can do a:
|
69
71
|
|
70
|
-
|
72
|
+
cap deploy:restart
|
71
73
|
|
72
74
|
This will restart the application for Passenger.
|
73
75
|
|
74
|
-
|
76
|
+
cap deploy:setup
|
75
77
|
|
76
78
|
This will run the setup task, which will do everything Capistrano does out of the box,
|
77
79
|
but also executes the tasks I mentioned at the top of this README.
|
78
80
|
|
79
|
-
|
81
|
+
cap deploy
|
80
82
|
|
81
83
|
After you've setup Capistrano correctly using the cap deploy:setup, you may now use the above command to deploy your rails application!
|
82
84
|
|
data/Rakefile
CHANGED
@@ -9,7 +9,8 @@ begin
|
|
9
9
|
gem.email = "meskyan@gmail.com"
|
10
10
|
gem.homepage = "http://github.com/meskyanichi/generators"
|
11
11
|
gem.authors = ["Michael"]
|
12
|
-
|
12
|
+
gem.add_dependency('capistrano')
|
13
|
+
|
13
14
|
# gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
|
14
15
|
end
|
15
16
|
rescue LoadError
|
data/VERSION.yml
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: meskyanichi-generators
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.1.
|
4
|
+
version: 0.1.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Michael
|
@@ -11,8 +11,17 @@ cert_chain: []
|
|
11
11
|
|
12
12
|
date: 2009-06-02 00:00:00 -07:00
|
13
13
|
default_executable:
|
14
|
-
dependencies:
|
15
|
-
|
14
|
+
dependencies:
|
15
|
+
- !ruby/object:Gem::Dependency
|
16
|
+
name: capistrano
|
17
|
+
type: :runtime
|
18
|
+
version_requirement:
|
19
|
+
version_requirements: !ruby/object:Gem::Requirement
|
20
|
+
requirements:
|
21
|
+
- - ">="
|
22
|
+
- !ruby/object:Gem::Version
|
23
|
+
version: "0"
|
24
|
+
version:
|
16
25
|
description:
|
17
26
|
email: meskyan@gmail.com
|
18
27
|
executables: []
|