manage apps (create, destroy)
apps:create [NAME] create a new app --addons ADDONS # a comma-delimited list of addons to install -b, --buildpack BUILDPACK # a buildpack url to use for this app -n, --no-remote # don't create a git remote -r, --remote REMOTE # the git remote to create, default "heroku" -s, --stack STACK # the stack on which to create the app --region REGION # specify region for this app to run in -t, --tier TIER # HIDDEN: the tier for this app
Examples:
$ heroku apps:create Creating floating-dragon-42... done, stack is cedar http://floating-dragon-42.heroku.com/ | git@heroku.com:floating-dragon-42.git $ heroku apps:create -s bamboo Creating floating-dragon-42... done, stack is bamboo-mri-1.9.2 http://floating-dragon-42.herokuapp.com/ | git@heroku.com:floating-dragon-42.git # specify a name $ heroku apps:create example Creating example... done, stack is cedar http://example.heroku.com/ | git@heroku.com:example.git # create a staging app $ heroku apps:create example-staging --remote staging # create an app in the eu region $ heroku apps:create --region eu
# File lib/heroku/command/apps.rb, line 210 def create name = shift_argument || options[:app] || ENV['HEROKU_APP'] validate_arguments! info = api.post_app({ "name" => name, "region" => options[:region], "stack" => options[:stack], "tier" => options[:tier] }).body begin action("Creating #{info['name']}") do if info['create_status'] == 'creating' Timeout::timeout(options[:timeout].to_i) do loop do break if api.get_app(info['name']).body['create_status'] == 'complete' sleep 1 end end end if info['region'] status("region is #{info['region']}") else status("stack is #{info['stack']}") end end (options[:addons] || "").split(",").each do |addon| addon.strip! action("Adding #{addon} to #{info["name"]}") do api.post_addon(info["name"], addon) end end if buildpack = options[:buildpack] api.put_config_vars(info["name"], "BUILDPACK_URL" => buildpack) display("BUILDPACK_URL=#{buildpack}") end hputs([ info["web_url"], info["git_url"] ].join(" | ")) rescue Timeout::Error hputs("Timed Out! Run `heroku status` to check for known platform issues.") end unless options[:no_remote].is_a? FalseClass create_git_remote(options[:remote] || "heroku", info["git_url"]) end end
apps:destroy permanently destroy an app
Example:
$ heroku apps:destroy -a example --confirm example Destroying example (including all add-ons)... done
# File lib/heroku/command/apps.rb, line 326 def destroy @app = shift_argument || options[:app] || options[:confirm] validate_arguments! unless @app error("Usage: heroku apps:destroy --app APP\nMust specify APP to destroy.") end api.get_app(@app) # fail fast if no access or doesn't exist message = "WARNING: Potentially Destructive Action\nThis command will destroy #{@app} (including all add-ons)." if confirm_command(@app, message) action("Destroying #{@app} (including all add-ons)") do api.delete_app(@app) if remotes = git_remotes(Dir.pwd) remotes.each do |remote_name, remote_app| next if @app != remote_app git "remote rm #{remote_name}" end end end end end
apps:downgrade TIER
HIDDEN: downgrade an app's pricing tier
# File lib/heroku/command/apps.rb, line 373 def downgrade tier = shift_argument error("Usage: heroku apps:downgrade TIER\nMust specify TIER to downgrade.") if tier.nil? || tier.empty? validate_arguments! action("Upgrading #{app} to #{tier}") do api.put_app(app, "tier" => tier) end end
apps list your apps
Example:
$ heroku apps === My Apps example example2 === Collaborated Apps theirapp other@owner.name
# File lib/heroku/command/apps.rb, line 21 def index validate_arguments! apps = api.get_apps.body unless apps.empty? my_apps, collaborated_apps = apps.partition do |app| app["owner_email"] == Heroku::Auth.user end unless my_apps.empty? non_legacy_apps = my_apps.select do |app| app["tier"] != "legacy" end unless non_legacy_apps.empty? production_basic_apps, dev_legacy_apps = my_apps.partition do |app| ["production", "basic"].include?(app["tier"]) end unless production_basic_apps.empty? styled_header("Basic & Production Apps") styled_array(production_basic_apps.map { |app| regionized_app_name(app) }) end unless dev_legacy_apps.empty? styled_header("Dev & Legacy Apps") styled_array(dev_legacy_apps.map { |app| regionized_app_name(app) }) end else styled_header("My Apps") styled_array(my_apps.map { |app| regionized_app_name(app) }) end end unless collaborated_apps.empty? styled_header("Collaborated Apps") styled_array(collaborated_apps.map { |app| [regionized_app_name(app), app["owner_email"]] }) end else display("You have no apps.") end end
apps:info show detailed app information -s, --shell # output more shell friendly key/value pairs
Examples:
$ heroku apps:info === example Git URL: git@heroku.com:example.git Repo Size: 5M ... $ heroku apps:info --shell git_url=git@heroku.com:example.git repo_size=5000000 ...
# File lib/heroku/command/apps.rb, line 84 def info validate_arguments! app_data = api.get_app(app).body unless options[:shell] styled_header(app_data["name"]) end addons_data = api.get_addons(app).body.map {|addon| addon['name']}.sort collaborators_data = api.get_collaborators(app).body.map {|collaborator| collaborator["email"]}.sort collaborators_data.reject! {|email| email == app_data["owner_email"]} if options[:shell] if app_data['domain_name'] app_data['domain_name'] = app_data['domain_name']['domain'] end unless addons_data.empty? app_data['addons'] = addons_data.join(',') end unless collaborators_data.empty? app_data['collaborators'] = collaborators_data.join(',') end app_data.keys.sort_by { |a| a.to_s }.each do |key| hputs("#{key}=#{app_data[key]}") end else data = {} unless addons_data.empty? data["Addons"] = addons_data end data["Collaborators"] = collaborators_data if app_data["create_status"] && app_data["create_status"] != "complete" data["Create Status"] = app_data["create_status"] end if app_data["cron_finished_at"] data["Cron Finished At"] = format_date(app_data["cron_finished_at"]) end if app_data["cron_next_run"] data["Cron Next Run"] = format_date(app_data["cron_next_run"]) end if app_data["database_size"] data["Database Size"] = format_bytes(app_data["database_size"]) end data["Git URL"] = app_data["git_url"] if app_data["database_tables"] data["Database Size"].gsub!('(empty)', '0K') + " in #{quantify("table", app_data["database_tables"])}" end if app_data["dyno_hours"].is_a?(Hash) data["Dyno Hours"] = app_data["dyno_hours"].keys.map do |type| "%s - %0.2f dyno-hours" % [ type.to_s.capitalize, app_data["dyno_hours"][type] ] end end data["Owner Email"] = app_data["owner_email"] if app_data["region"] data["Region"] = app_data["region"] end if app_data["repo_size"] data["Repo Size"] = format_bytes(app_data["repo_size"]) end if app_data["slug_size"] data["Slug Size"] = format_bytes(app_data["slug_size"]) end data["Stack"] = app_data["stack"] if data["Stack"] != "cedar" data.merge!("Dynos" => app_data["dynos"], "Workers" => app_data["workers"]) end data["Web URL"] = app_data["web_url"] if app_data["tier"] data["Tier"] = app_data["tier"].capitalize end styled_hash(data) end end
apps:open open the app in a web browser
Example:
$ heroku apps:open Opening example... done
# File lib/heroku/command/apps.rb, line 308 def open validate_arguments! app_data = api.get_app(app).body launchy("Opening #{app}", app_data['web_url']) end
apps:rename NEWNAME rename the app
Example:
$ heroku apps:rename example-newname http://example-newname.herokuapp.com/ | git@heroku.com:example-newname.git Git remote heroku updated
# File lib/heroku/command/apps.rb, line 271 def rename newname = shift_argument if newname.nil? || newname.empty? error("Usage: heroku apps:rename NEWNAME\nMust specify NEWNAME to rename.") end validate_arguments! action("Renaming #{app} to #{newname}") do api.put_app(app, "name" => newname) end app_data = api.get_app(newname).body hputs([ app_data["web_url"], app_data["git_url"] ].join(" | ")) if remotes = git_remotes(Dir.pwd) remotes.each do |remote_name, remote_app| next if remote_app != app git "remote rm #{remote_name}" git "remote add #{remote_name} #{app_data["git_url"]}" hputs("Git remote #{remote_name} updated") end else hputs("Don't forget to update your Git remotes on any local checkouts.") end end
apps:upgrade TIER
HIDDEN: upgrade an app's pricing tier
# File lib/heroku/command/apps.rb, line 357 def upgrade tier = shift_argument error("Usage: heroku apps:upgrade TIER\nMust specify TIER to upgrade.") if tier.nil? || tier.empty? validate_arguments! action("Upgrading #{app} to #{tier}") do api.put_app(app, "tier" => tier) end end
# File lib/heroku/command/apps.rb, line 387 def regionized_app_name(app) # temporary, show region for non-us apps if app["region"] && app["region"] != 'us' "#{app["name"]} (#{app["region"]})" else app["name"] end end