diff options
author | Tim Smith <tsmith@chef.io> | 2019-05-03 09:50:34 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-05-03 09:50:34 -0700 |
commit | 50e700570b11558c57a1559e5af35b5e636ecfe2 (patch) | |
tree | c18d3c3a82fbf1d893bfd060d936e192f178d700 /lib/chef/application/client.rb | |
parent | f2641489648dfdb428ffb9b0d83918ac976ec472 (diff) | |
parent | e914d191b7c979149fd3aa59fe621e79db435da3 (diff) | |
download | chef-50e700570b11558c57a1559e5af35b5e636ecfe2.tar.gz |
Merge pull request #8452 from chef/branding
Add connstant for Chef Server and improve help messaging
Diffstat (limited to 'lib/chef/application/client.rb')
-rw-r--r-- | lib/chef/application/client.rb | 86 |
1 files changed, 43 insertions, 43 deletions
diff --git a/lib/chef/application/client.rb b/lib/chef/application/client.rb index ee3e0f7f04..390acfba04 100644 --- a/lib/chef/application/client.rb +++ b/lib/chef/application/client.rb @@ -2,7 +2,7 @@ # Author:: AJ Christensen (<aj@chef.io) # Author:: Christopher Brown (<cb@chef.io>) # Author:: Mark Mzyk (mmzyk@chef.io) -# Copyright:: Copyright 2008-2018, Chef Software Inc. +# Copyright:: Copyright 2008-2019, Chef Software Inc. # License:: Apache License, Version 2.0 # # Licensed under the Apache License, Version 2.0 (the "License"); @@ -41,11 +41,11 @@ class Chef::Application::Client < Chef::Application option :config_file, short: "-c CONFIG", long: "--config CONFIG", - description: "The configuration file to use" + description: "The configuration file to use." option :config_option, long: "--config-option OPTION=VALUE", - description: "Override a single configuration option", + description: "Override a single configuration option.", proc: lambda { |option, existing| (existing ||= []) << option existing @@ -54,24 +54,24 @@ class Chef::Application::Client < Chef::Application option :formatter, short: "-F FORMATTER", long: "--format FORMATTER", - description: "output format to use", + description: "The output format to use.", proc: lambda { |format| Chef::Config.add_formatter(format) } option :force_logger, long: "--force-logger", - description: "Use logger output instead of formatter output", + description: "Use logger output instead of formatter output.", boolean: true, default: false option :force_formatter, long: "--force-formatter", - description: "Use formatter output instead of logger output", + description: "Use formatter output instead of logger output.", boolean: true, default: false option :profile_ruby, long: "--[no-]profile-ruby", - description: "Dump complete Ruby call graph stack of entire #{Chef::Dist::PRODUCT} run (expert only)", + description: "Dump complete Ruby call graph stack of entire #{Chef::Dist::PRODUCT} run (expert only).", boolean: true, default: false @@ -79,24 +79,24 @@ class Chef::Application::Client < Chef::Application long: "--[no-]color", boolean: true, default: true, - description: "Use colored output, defaults to enabled" + description: "Use colored output, defaults to enabled." option :log_level, short: "-l LEVEL", long: "--log_level LEVEL", - description: "Set the log level (auto, trace, debug, info, warn, error, fatal)", + description: "Set the log level (auto, trace, debug, info, warn, error, fatal).", proc: lambda { |l| l.to_sym } option :log_location, short: "-L LOGLOCATION", long: "--logfile LOGLOCATION", - description: "Set the log file location, defaults to STDOUT - recommended for daemonizing", + description: "Set the log file location, defaults to STDOUT - recommended for daemonizing.", proc: nil option :help, short: "-h", long: "--help", - description: "Show this message", + description: "Show this help message.", on: :tail, boolean: true, show_options: true, @@ -105,20 +105,20 @@ class Chef::Application::Client < Chef::Application option :user, short: "-u USER", long: "--user USER", - description: "User to set privilege to", + description: "User to set privilege to.", proc: nil option :group, short: "-g GROUP", long: "--group GROUP", - description: "Group to set privilege to", + description: "Group to set privilege to.", proc: nil unless Chef::Platform.windows? option :daemonize, short: "-d [WAIT]", long: "--daemonize [WAIT]", - description: "Daemonize the process. Accepts an optional integer which is the " \ + description: "Daemonize the process. Accepts an optional integer which is the " \ "number of seconds to wait before the first daemonized run.", proc: lambda { |wait| wait =~ /^\d+$/ ? wait.to_i : true } end @@ -126,75 +126,75 @@ class Chef::Application::Client < Chef::Application option :pid_file, short: "-P PID_FILE", long: "--pid PIDFILE", - description: "Set the PID file location, for the #{Chef::Dist::CLIENT} daemon process. Defaults to /tmp/chef-client.pid", + description: "Set the PID file location, for the #{Chef::Dist::CLIENT} daemon process. Defaults to /tmp/chef-client.pid.", proc: nil option :lockfile, long: "--lockfile LOCKFILE", - description: "Set the lockfile location. Prevents multiple client processes from converging at the same time", + description: "Set the lockfile location. Prevents multiple client processes from converging at the same time.", proc: nil option :interval, short: "-i SECONDS", long: "--interval SECONDS", - description: "Run #{Chef::Dist::CLIENT} periodically, in seconds", + description: "Run #{Chef::Dist::CLIENT} periodically, in seconds.", proc: lambda { |s| s.to_i } option :once, long: "--once", - description: "Cancel any interval or splay options, run #{Chef::Dist::CLIENT} once and exit", + description: "Cancel any interval or splay options, run #{Chef::Dist::CLIENT} once and exit.", boolean: true option :json_attribs, short: "-j JSON_ATTRIBS", long: "--json-attributes JSON_ATTRIBS", - description: "Load attributes from a JSON file or URL", + description: "Load attributes from a JSON file or URL.", proc: nil option :node_name, short: "-N NODE_NAME", long: "--node-name NODE_NAME", - description: "The node name for this client", + description: "The node name for this client.", proc: nil option :splay, short: "-s SECONDS", long: "--splay SECONDS", - description: "The splay time for running at intervals, in seconds", + description: "The splay time for running at intervals, in seconds.", proc: lambda { |s| s.to_i } option :chef_server_url, short: "-S CHEFSERVERURL", long: "--server CHEFSERVERURL", - description: "The #{Chef::Dist::PRODUCT} server URL", + description: "The #{Chef::Dist::SERVER_PRODUCT} URL.", proc: nil option :validation_key, short: "-K KEY_FILE", long: "--validation_key KEY_FILE", - description: "Set the validation key file location, used for registering new clients", + description: "Set the validation key file location, used for registering new clients.", proc: nil option :client_key, short: "-k KEY_FILE", long: "--client_key KEY_FILE", - description: "Set the client key file location", + description: "Set the client key file location.", proc: nil option :named_run_list, short: "-n NAMED_RUN_LIST", long: "--named-run-list NAMED_RUN_LIST", - description: "Use a policyfile's named run list instead of the default run list" + description: "Use a policyfile's named run list instead of the default run list." option :environment, short: "-E ENVIRONMENT", long: "--environment ENVIRONMENT", - description: "Set the #{Chef::Dist::PRODUCT} Environment on the node" + description: "Set the #{Chef::Dist::PRODUCT} environment on the node." option :version, short: "-v", long: "--version", - description: "Show #{Chef::Dist::PRODUCT} version", + description: "Show #{Chef::Dist::PRODUCT} version.", boolean: true, proc: lambda { |v| puts "#{Chef::Dist::PRODUCT}: #{::Chef::VERSION}" }, exit: 0 @@ -202,7 +202,7 @@ class Chef::Application::Client < Chef::Application option :override_runlist, short: "-o RunlistItem,RunlistItem...", long: "--override-runlist RunlistItem,RunlistItem...", - description: "Replace current run list with specified items for a single run", + description: "Replace current run list with specified items for a single run.", proc: lambda { |items| items = items.split(",") items.compact.map do |item| @@ -213,7 +213,7 @@ class Chef::Application::Client < Chef::Application option :runlist, short: "-r RunlistItem,RunlistItem...", long: "--runlist RunlistItem,RunlistItem...", - description: "Permanently replace current run list with specified items", + description: "Permanently replace current run list with specified items.", proc: lambda { |items| items = items.split(",") items.compact.map do |item| @@ -223,13 +223,13 @@ class Chef::Application::Client < Chef::Application option :why_run, short: "-W", long: "--why-run", - description: "Enable whyrun mode", + description: "Enable whyrun mode.", boolean: true option :client_fork, short: "-f", long: "--[no-]fork", - description: "Fork client" + description: "Fork #{Chef::Dist::CLIENT} process." option :recipe_url, long: "--recipe-url=RECIPE_URL", @@ -238,26 +238,26 @@ class Chef::Application::Client < Chef::Application option :enable_reporting, short: "-R", long: "--enable-reporting", - description: "Enable reporting data collection for #{Chef::Dist::PRODUCT} runs", + description: "Enable reporting data collection for #{Chef::Dist::PRODUCT} runs.", boolean: true option :local_mode, short: "-z", long: "--local-mode", - description: "Point #{Chef::Dist::CLIENT} at local repository", + description: "Point #{Chef::Dist::CLIENT} at local repository.", boolean: true option :chef_zero_host, long: "--chef-zero-host HOST", - description: "Host to start chef-zero on" + description: "Host to start chef-zero on." option :chef_zero_port, long: "--chef-zero-port PORT", - description: "Port (or port range) to start chef-zero on. Port ranges like 1000,1010 or 8889-9999 will try all given ports until one works." + description: "Port (or port range) to start chef-zero on. Port ranges like 1000,1010 or 8889-9999 will try all given ports until one works." option :disable_config, long: "--disable-config", - description: "Refuse to load a config file and use defaults. This is for development and not a stable API", + description: "Refuse to load a config file and use defaults. This is for development and not a stable API.", boolean: true option :run_lock_timeout, @@ -269,33 +269,33 @@ class Chef::Application::Client < Chef::Application option :fatal_windows_admin_check, short: "-A", long: "--fatal-windows-admin-check", - description: "Fail the run when #{Chef::Dist::CLIENT} doesn't have administrator privileges on Windows", + description: "Fail the run when #{Chef::Dist::CLIENT} doesn't have administrator privileges on Windows.", boolean: true end option :minimal_ohai, long: "--minimal-ohai", - description: "Only run the bare minimum ohai plugins #{Chef::Dist::CLIENT} needs to function", + description: "Only run the bare minimum Ohai plugins #{Chef::Dist::PRODUCT} needs to function.", boolean: true option :listen, long: "--[no-]listen", - description: "Whether a local mode (-z) server binds to a port", + description: "Whether a local mode (-z) server binds to a port.", boolean: false option :fips, long: "--[no-]fips", - description: "Enable fips mode", + description: "Enable FIPS mode.", boolean: true option :delete_entire_chef_repo, long: "--delete-entire-chef-repo", - description: "DANGEROUS: does what it says, only useful with --recipe-url", + description: "DANGEROUS: does what it says, only useful with --recipe-url.", boolean: true option :skip_cookbook_sync, long: "--[no-]skip-cookbook-sync", - description: "Use cached cookbooks without overwriting local differences from the server", + description: "Use cached cookbooks without overwriting local differences from the #{Chef::Dist::SERVER_PRODUCT}.", boolean: false IMMEDIATE_RUN_SIGNAL = "1".freeze @@ -504,7 +504,7 @@ class Chef::Application::Client < Chef::Application end def unforked_interval_error_message - "Unforked #{Chef::Dist::CLIENT} interval runs are disabled in #{Chef::Dist::PRODUCT} 12." + + "Unforked #{Chef::Dist::CLIENT} interval runs are disabled by default." + "\nConfiguration settings:" + ("\n interval = #{Chef::Config[:interval]} seconds" if Chef::Config[:interval]).to_s + "\nEnable #{Chef::Dist::CLIENT} interval runs by setting `:client_fork = true` in your config file or adding `--fork` to your command line options." |