class Kamal::Cli::Main < Kamal::Cli::Base desc "setup", "Setup all accessories, push the env, and deploy app to servers" option :skip_push, aliases: "-P", type: :boolean, default: false, desc: "Skip image build and push" def setup print_runtime do with_lock do invoke_options = deploy_options say "Ensure Docker is installed...", :magenta invoke "kamal:cli:server:bootstrap", [], invoke_options deploy(boot_accessories: true) end end end desc "deploy", "Deploy app to servers" option :skip_push, aliases: "-P", type: :boolean, default: false, desc: "Skip image build and push" def deploy(boot_accessories: false) runtime = print_runtime do invoke_options = deploy_options say "Log into image registry...", :magenta invoke "kamal:cli:registry:login", [], invoke_options.merge(skip_local: options[:skip_push]) if options[:skip_push] say "Pull app image...", :magenta invoke "kamal:cli:build:pull", [], invoke_options else say "Build and push app image...", :magenta invoke "kamal:cli:build:deliver", [], invoke_options end with_lock do run_hook "pre-deploy", secrets: true say "Ensure kamal-proxy is running...", :magenta invoke "kamal:cli:proxy:boot", [], invoke_options invoke "kamal:cli:accessory:boot", [ "all" ], invoke_options if boot_accessories say "Detect stale containers...", :magenta invoke "kamal:cli:app:stale_containers", [], invoke_options.merge(stop: true) invoke "kamal:cli:app:boot", [], invoke_options say "Prune old containers and images...", :magenta invoke "kamal:cli:prune:all", [], invoke_options end end run_hook "post-deploy", secrets: true, runtime: runtime.round.to_s end desc "redeploy", "Deploy app to servers without bootstrapping servers, starting kamal-proxy, pruning, and registry login" option :skip_push, aliases: "-P", type: :boolean, default: false, desc: "Skip image build and push" def redeploy runtime = print_runtime do invoke_options = deploy_options if options[:skip_push] say "Pull app image...", :magenta invoke "kamal:cli:build:pull", [], invoke_options else say "Build and push app image...", :magenta invoke "kamal:cli:build:deliver", [], invoke_options end with_lock do run_hook "pre-deploy", secrets: true say "Detect stale containers...", :magenta invoke "kamal:cli:app:stale_containers", [], invoke_options.merge(stop: true) invoke "kamal:cli:app:boot", [], invoke_options end end run_hook "post-deploy", secrets: true, runtime: runtime.round.to_s end desc "rollback [VERSION]", "Rollback app to VERSION" def rollback(version) rolled_back = false runtime = print_runtime do with_lock do invoke_options = deploy_options KAMAL.config.version = version old_version = nil if container_available?(version) run_hook "pre-deploy", secrets: true invoke "kamal:cli:app:boot", [], invoke_options.merge(version: version) rolled_back = true else say "The app version '#{version}' is not available as a container (use 'kamal app containers' for available versions)", :red end end end run_hook "post-deploy", secrets: true, runtime: runtime.round.to_s if rolled_back end desc "details", "Show details about all containers" def details invoke "kamal:cli:proxy:details" invoke "kamal:cli:app:details" invoke "kamal:cli:accessory:details", [ "all" ] end desc "audit", "Show audit log from servers" def audit on(KAMAL.hosts) do |host| puts_by_host host, capture_with_info(*KAMAL.auditor.reveal) end end desc "config", "Show combined config (including secrets!)" def config run_locally do puts Kamal::Utils.redacted(KAMAL.config.to_h).to_yaml end end desc "docs [SECTION]", "Show Kamal configuration documentation" def docs(section = nil) case section when NilClass puts Kamal::Configuration.validation_doc else puts Kamal::Configuration.const_get(section.titlecase.to_sym).validation_doc end rescue NameError puts "No documentation found for #{section}" end desc "init", "Create config stub in config/deploy.yml and secrets stub in .kamal" option :bundle, type: :boolean, default: false, desc: "Add Kamal to the Gemfile and create a bin/kamal binstub" def init require "fileutils" if (deploy_file = Pathname.new(File.expand_path("config/deploy.yml"))).exist? puts "Config file already exists in config/deploy.yml (remove first to create a new one)" else FileUtils.mkdir_p deploy_file.dirname FileUtils.cp_r Pathname.new(File.expand_path("templates/deploy.yml", __dir__)), deploy_file puts "Created configuration file in config/deploy.yml" end unless (secrets_file = Pathname.new(File.expand_path(".kamal/secrets"))).exist? FileUtils.mkdir_p secrets_file.dirname FileUtils.cp_r Pathname.new(File.expand_path("templates/secrets", __dir__)), secrets_file puts "Created .kamal/secrets file" end unless (hooks_dir = Pathname.new(File.expand_path(".kamal/hooks"))).exist? hooks_dir.mkpath Pathname.new(File.expand_path("templates/sample_hooks", __dir__)).each_child do |sample_hook| FileUtils.cp sample_hook, hooks_dir, preserve: true end puts "Created sample hooks in .kamal/hooks" end if options[:bundle] if (binstub = Pathname.new(File.expand_path("bin/kamal"))).exist? puts "Binstub already exists in bin/kamal (remove first to create a new one)" else puts "Adding Kamal to Gemfile and bundle..." run_locally do execute :bundle, :add, :kamal execute :bundle, :binstubs, :kamal end puts "Created binstub file in bin/kamal" end end end desc "remove", "Remove kamal-proxy, app, accessories, and registry session from servers" option :confirmed, aliases: "-y", type: :boolean, default: false, desc: "Proceed without confirmation question" def remove confirming "This will remove all containers and images. Are you sure?" do with_lock do invoke "kamal:cli:app:remove", [], options.without(:confirmed) invoke "kamal:cli:proxy:remove", [], options.without(:confirmed) invoke "kamal:cli:accessory:remove", [ "all" ], options invoke "kamal:cli:registry:logout", [], options.without(:confirmed).merge(skip_local: true) end end end desc "upgrade", "Upgrade from Kamal 1.x to 2.0" option :confirmed, aliases: "-y", type: :boolean, default: false, desc: "Proceed without confirmation question" option :rolling, type: :boolean, default: false, desc: "Upgrade one host at a time" def upgrade confirming "This will replace Traefik with kamal-proxy and restart all accessories" do with_lock do if options[:rolling] (KAMAL.hosts | KAMAL.accessory_hosts).each do |host| KAMAL.with_specific_hosts(host) do say "Upgrading #{host}...", :magenta if KAMAL.hosts.include?(host) invoke "kamal:cli:proxy:upgrade", [], options.merge(confirmed: true, rolling: false) reset_invocation(Kamal::Cli::Proxy) end if KAMAL.accessory_hosts.include?(host) invoke "kamal:cli:accessory:upgrade", [ "all" ], options.merge(confirmed: true, rolling: false) reset_invocation(Kamal::Cli::Accessory) end say "Upgraded #{host}", :magenta end end else say "Upgrading all hosts...", :magenta invoke "kamal:cli:proxy:upgrade", [], options.merge(confirmed: true) invoke "kamal:cli:accessory:upgrade", [ "all" ], options.merge(confirmed: true) say "Upgraded all hosts", :magenta end end end end desc "version", "Show Kamal version" def version puts Kamal::VERSION end desc "accessory", "Manage accessories (db/redis/search)" subcommand "accessory", Kamal::Cli::Accessory desc "app", "Manage application" subcommand "app", Kamal::Cli::App desc "build", "Build application image" subcommand "build", Kamal::Cli::Build desc "lock", "Manage the deploy lock" subcommand "lock", Kamal::Cli::Lock desc "proxy", "Manage kamal-proxy" subcommand "proxy", Kamal::Cli::Proxy desc "prune", "Prune old application images and containers" subcommand "prune", Kamal::Cli::Prune desc "registry", "Login and -out of the image registry" subcommand "registry", Kamal::Cli::Registry desc "secrets", "Helpers for extracting secrets" subcommand "secrets", Kamal::Cli::Secrets desc "server", "Bootstrap servers with curl and Docker" subcommand "server", Kamal::Cli::Server private def container_available?(version) begin on(KAMAL.hosts) do KAMAL.roles_on(host).each do |role| container_id = capture_with_info(*KAMAL.app(role: role, host: host).container_id_for_version(version)) raise "Container not found" unless container_id.present? end end rescue SSHKit::Runner::ExecuteError, SSHKit::Runner::MultipleExecuteError => e if e.message =~ /Container not found/ say "Error looking for container version #{version}: #{e.message}" return false else raise end end true end def deploy_options { "version" => KAMAL.config.version }.merge(options.without("skip_push")) end end