cookbook 'carton', '~> 0.1.5'
carton (4) Versions 0.1.5 Follow2
Installs/Configures carton and provides a LWRP
cookbook 'carton', '~> 0.1.5', :supermarket
knife supermarket install carton
knife supermarket download carton
Description
To date, this cookbook has only been designed and tested on the
Ubuntu and Debian platforms. Centos is provisionally working...
Requirements
The carton cookbook depends on 'perlbrew' and an older version of the 'runit' cookbook.
The 'perlbrew' cookbook is available from the
Opscode Community site or from
the perl-chef git repository.
Attributes
-
node['carton']['perlbrew'] = 'perl-5.14.2'- Sets default perl for carton apps if not specified by user
Recipes
carton
Loads the 'perlbrew' and 'runit' recipes to ensure those LWRPs are ready for use. This must be loaded
before using the 'carton_app' LWRP.
Resources/Providers
carton_app
This LWRP sets up a carton application as
a runit service and passes through runit commands to start/stop or otherwise
control the service.
Example:
carton_app "hello-world" do
perlbrew node['hello-world']['perl_version']
command "starman -p #{node['hello-world']['port']} app.psgi"
cwd node['hello-world']['deploy_dir']
user node['hello-world']['user']
group node['hello-world']['group']
end
carton_app "hello-world" do
action :start
end
This installs all dependencies of a carton app in a deployment directory using
a particular perl, sets up a runit service using the given command, and
starts the service.
Actions:
- :enable - ensure carton dependencies are installed and set up the runit service (default action)
- :disable - disables the runit service
- :start - start the service
- :stop - stop the service
- :restart - restart the service
Attributes:
- :perlbrew - name of a perlbrew perl to use to run the application. This will be installed using the perlbrew LWRP if not already availble
- :command - shell command to launch the application. This must launch the application in the foreground; runit will ensure it is properly daemonized
- :cwd - directory containing the application. The service will also be launched in this directory (via "carton exec -I lib -- $command").
- :user - user under which the service will run
- :group - group under which the service will run
- :environment - a hash of environment variables that will be set prior to running the service
Usage
If you wish to use the LWRP, be sure to include the carton recipe, which
ensures that carton is ready for use.
Dependent cookbooks
| perlbrew >= 0.1.1 |
| runit >= 0.0.0 |
| apt >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
0.1.5 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.1.5 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.1.5 failed this metric
FC064: Ensure issues_url is set in metadata: carton/metadata.rb:1
FC065: Ensure source_url is set in metadata: carton/metadata.rb:1
FC066: Ensure chef_version is set in metadata: carton/metadata.rb:1
FC069: Ensure standardized license defined in metadata: carton/metadata.rb:1
FC074: LWRP should use DSL to define resource's default action: carton/resources/app.rb:1
FC074: LWRP should use DSL to define resource's default action: carton/resources/exec.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:88
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:95
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:102
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:109
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:115
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/exec.rb:62
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.1.5 passed this metric
Testing File Metric
0.1.5 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.1.5 passed this metric
0.1.5 failed this metric
0.1.5 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.1.5 failed this metric
FC064: Ensure issues_url is set in metadata: carton/metadata.rb:1
FC065: Ensure source_url is set in metadata: carton/metadata.rb:1
FC066: Ensure chef_version is set in metadata: carton/metadata.rb:1
FC069: Ensure standardized license defined in metadata: carton/metadata.rb:1
FC074: LWRP should use DSL to define resource's default action: carton/resources/app.rb:1
FC074: LWRP should use DSL to define resource's default action: carton/resources/exec.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:88
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:95
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:102
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:109
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:115
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/exec.rb:62
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.1.5 passed this metric
Testing File Metric
0.1.5 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.1.5 passed this metric
0.1.5 failed this metric
FC065: Ensure source_url is set in metadata: carton/metadata.rb:1
FC066: Ensure chef_version is set in metadata: carton/metadata.rb:1
FC069: Ensure standardized license defined in metadata: carton/metadata.rb:1
FC074: LWRP should use DSL to define resource's default action: carton/resources/app.rb:1
FC074: LWRP should use DSL to define resource's default action: carton/resources/exec.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:88
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:95
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:102
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:109
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/app.rb:115
FC085: Resource using new_resource.updated_by_last_action to converge resource: carton/providers/exec.rb:62
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
0.1.5 passed this metric
Testing File Metric
0.1.5 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.1.5 passed this metric
0.1.5 failed this metric
0.1.5 passed this metric
