cpl 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5989a3c887eb311dcfb8bffe88e8519172b21efd21e715c363e7a166b73dbc3
-  data.tar.gz: b9fc9896cdd99a38b89389866f0f0825cb3944099e4579f4641ee221f2302a92
+  metadata.gz: 976c390927b51f67afe7a161b7185242261afb4c24db893026457b205fe61b12
+  data.tar.gz: b55bec82c485eb413c9a8787d34172e2c7e89212c15e319f3f626c652c3ac6e7
 SHA512:
-  metadata.gz: c73027a84228c2371999bdff122d3bab5a3970d5f11c54f55a4b47a0fae77f83903e8d5702ecdd6baa5ac9fe6346f8e433f395a6fc3e22ee3a7225ed661038c3
-  data.tar.gz: a2734ae8f9969be0d523dd547783284774ad461fa1dee36174a5c6bc6b653ec7a020c2c07301e31c787d5d4f7b04c4a6d983fe1e544d2d20410a54f19896d7ff
+  metadata.gz: 678825b452c56d5c481639de70904ab087f29e362c4b8ced34d3c2131f15a176f78c0c928b02449ebc96a0e69bd1e5c2cd1982577e06a0b62000aa0993bd4f91
+  data.tar.gz: a40e2ea6bfb43122c919d9126d6fffdb6a9722396bed1c4b22b5874d06f9b2126ee4f14e6df37047bb417bcb0788b3b19869d03b34801030b6e8e373f47950c2

data/.rubocop.yml

@@ -14,3 +14,9 @@ Style/Documentation:
 
 Style/StringLiterals:
   EnforcedStyle: double_quotes
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cpl (0.5.1)
+    cpl (0.7.0)
       debug (~> 1.7.1)
       dotenv (~> 2.8.1)
       psych (~> 5.1.0)
@@ -10,17 +10,22 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    addressable (2.8.4)
+      public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     childprocess (4.1.0)
+    crack (0.4.5)
+      rexml
     debug (1.7.2)
       irb (>= 1.5.0)
       reline (>= 0.3.1)
     diff-lcs (1.5.0)
     docile (1.4.0)
     dotenv (2.8.1)
+    hashdiff (1.0.1)
     iniparse (1.5.0)
     io-console (0.6.0)
-    irb (1.6.3)
+    irb (1.6.4)
       reline (>= 0.3.0)
     json (2.6.3)
     overcommit (0.60.0)
@@ -32,6 +37,7 @@ GEM
       ast (~> 2.4.1)
     psych (5.1.0)
       stringio
+    public_suffix (5.0.1)
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.6.2)
@@ -77,9 +83,15 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.12.3)
     simplecov_json_formatter (0.1.4)
-    stringio (3.0.5)
-    thor (1.2.1)
+    stringio (3.0.6)
+    thor (1.2.2)
+    timecop (0.9.6)
     unicode-display_width (2.4.2)
+    vcr (6.1.0)
+    webmock (3.18.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
   ruby
@@ -94,6 +106,9 @@ DEPENDENCIES
   rubocop-rake (~> 0.6.0)
   rubocop-rspec (~> 2.18.1)
   simplecov (~> 0.22.0)
+  timecop (~> 0.9.6)
+  vcr (~> 6.1.0)
+  webmock (~> 3.18.1)
 
 BUNDLED WITH
    2.3.26

data/README.md

@@ -28,11 +28,12 @@ To simplify migration to and usage of Control Plane for Heroku users, this repos
 6. [Environment](#environment)
 7. [Database](#database)
 8. [In-memory databases](#in-memory-databases)
-9. [CLI commands reference](#cli-commands-reference)
-10. [Mapping of Heroku Commands to `cpl` and `cpln`](#mapping-of-heroku-commands-to-cpl-and-cpln)
-11. [Examples](#examples)
-12. [Migrating Postgres database from Heroku infrastructure](/docs/postgres.md)
-13. [Migrating Redis database from Heroku infrastructure](/docs/redis.md)
+9. [Scheduled jobs](#scheduled-jobs)
+10. [CLI commands reference](#cli-commands-reference)
+11. [Mapping of Heroku Commands to `cpl` and `cpln`](#mapping-of-heroku-commands-to-cpl-and-cpln)
+12. [Examples](#examples)
+13. [Migrating Postgres database from Heroku infrastructure](/docs/postgres.md)
+14. [Migrating Redis database from Heroku infrastructure](/docs/redis.md)
 
 ## Key features
 
@@ -105,14 +106,28 @@ Do not confuse the `cpl` CLI with the `cpln` CLI. The `cpl` CLI is the Heroku to
 **Notes:**
 
 1. `myapp` is an app name defined in the `.controlplane/controlplane.yml` file, such as `ror-tutorial` in [this `controlplane.yml` file](https://github.com/shakacode/react-webpack-rails-tutorial/blob/master/.controlplane/controlplane.yml).
-2. Other files in the `.controlplane/templates` directory are used by the `cpl setup` command.
+2. Other files in the `.controlplane/templates` directory are used by the `cpl setup-app` and `cpl apply-template` commands.
 
 ### Initial Setup and Deployment
 
+Before the initial setup, add the templates for the app to `.controlplane/controlplane.yml`, using the `setup` key:
+
+```yaml
+myapp:
+  setup:
+    - gvc
+    - postgres
+    - redis
+    - memcached
+    - rails
+    - sidekiq
+```
+
+Note how the templates correspond to files in the `.controlplane/templates` directory.
+
 ```sh
 # Provision infrastructure (one-time-only for new apps) using templates.
-# Note how the arguments correspond to files in the `.controlplane/templates` directory.
-cpl setup gvc postgres redis memcached rails sidekiq -a myapp
+cpl setup-app -a myapp
 
 # Build and push image with auto-tagging "myapp:1_456".
 cpl build-image -a myapp --commit 456
@@ -214,7 +229,7 @@ apps:
     <<: *common
     # Use a different organization for production.
     cpln_org: my-org-production
-    # Allows running the command `cpl pipeline-promote my-app-staging` to promote the staging app to production.
+    # Allows running the command `cpl promote-app-from-upstream -a my-app-production` to promote the staging app to production.
     upstream: my-app-staging
   my-app-other:
     <<: *common
@@ -313,6 +328,38 @@ For production purposes or where restarts are not an option, you should use exte
 We provide default `redis` and `memcached` templates in this repo optimized for Control Plane and suitable
 for development purposes.
 
+## Scheduled jobs
+
+Control Plane supports scheduled jobs via [cron workloads](https://docs.controlplane.com/reference/workload#cron).
+
+Here's a partial example of a template for a cron workload, using the app image:
+
+```yaml
+kind: workload
+name: daily-task
+spec:
+  type: cron
+  job:
+    # Run daily job at 2am
+    schedule: 0  2  *  *  *
+    # Never or OnFailure
+    restartPolicy: Never
+  containers:
+    - name: daily-task
+      args:
+        - bundle
+        - exec
+        - rails
+        - db:prepare
+      image: "/org/APP_ORG/image/APP_IMAGE"
+```
+
+A complete example can be found at [templates/daily-task.yml](templates/daily-task.yml), optimized for Control Plane and suitable for development purposes.
+
+You can create the cron workload by adding the template for it to the `.controlplane/templates` folder and running `cpl apply-template my-template -a my-app`, where `my-template` is the name of the template file (`my-template.yml`).
+
+Then to view the logs of the cron workload, you can run `cpl logs -a my-app -w my-template`.
+
 ## CLI commands reference:
 
 Click [here](/docs/commands.md) to see the commands.
@@ -327,17 +374,17 @@ cpl --help
 
 **`[WIP]`**
 
-| Heroku Command                                                                                                 | `cpl` or `cpln` |
-| -------------------------------------------------------------------------------------------------------------- | --------------- |
-| [heroku ps](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-ps-type-type)                     | `cpl ps`        |
-| [heroku config](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-config)                       | ?               |
-| [heroku maintenance](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-maintenance)             | ?               |
-| [heroku logs](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-logs)                           | `cpl logs`      |
-| [heroku pg](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-pg-database)                      | ?               |
-| [heroku pipelines:promote](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-pipelines-promote) | `cpl promote`   |
-| [heroku psql](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-psql-database)                  | ?               |
-| [heroku redis](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-redis-database)                | ?               |
-| [heroku releases](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-releases)                   | ?               |
+| Heroku Command                                                                                                 | `cpl` or `cpln`                 |
+| -------------------------------------------------------------------------------------------------------------- | ------------------------------- |
+| [heroku ps](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-ps-type-type)                     | `cpl ps`                        |
+| [heroku config](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-config)                       | ?                               |
+| [heroku maintenance](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-maintenance)             | `cpl maintenance`               |
+| [heroku logs](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-logs)                           | `cpl logs`                      |
+| [heroku pg](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-pg-database)                      | ?                               |
+| [heroku pipelines:promote](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-pipelines-promote) | `cpl promote-app-from-upstream` |
+| [heroku psql](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-psql-database)                  | ?                               |
+| [heroku redis](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-redis-database)                | ?                               |
+| [heroku releases](https://devcenter.heroku.com/articles/heroku-cli-commands#heroku-releases)                   | ?                               |
 
 ## Examples
 

data/Rakefile

@@ -4,11 +4,11 @@ require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 require "rubocop/rake_task"
 
-RSpec::Core::RakeTask.new(:spec)
+RSpec::Core::RakeTask.new(:rspec)
 
 RuboCop::RakeTask.new
 
-task default: %i[spec rubocop]
+task default: %i[rspec rubocop]
 
 desc "Updates commands.md file"
 task :command_docs do

data/cpl.gemspec

@@ -26,6 +26,9 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rubocop-rake",  "~> 0.6.0"
   spec.add_development_dependency "rubocop-rspec", "~> 2.18.1"
   spec.add_development_dependency "simplecov",     "~> 0.22.0"
+  spec.add_development_dependency "timecop",       "~> 0.9.6"
+  spec.add_development_dependency "vcr",           "~> 6.1.0"
+  spec.add_development_dependency "webmock",       "~> 3.18.1"
 
   spec.files = `git ls-files -z`.split("\x0").reject do |file|
     file.match(%r{^(coverage|pkg|spec|tmp)/})

data/docs/commands.md

@@ -11,11 +11,36 @@ This `-a` option is used in most of the commands and will pick all other app con
 
 ### Commands
 
+### `apply-template`
+
+- Applies application-specific configs from templates (e.g., for every review-app)
+- Publishes (creates or updates) those at Control Plane infrastructure
+- Picks templates from the `.controlplane/templates` directory
+- Templates are ordinary Control Plane templates but with variable preprocessing
+
+**Preprocessed template variables:**
+
+```
+APP_GVC      - basically GVC or app name
+APP_LOCATION - default location
+APP_ORG      - organization
+APP_IMAGE    - will use latest app image
+```
+
+```sh
+# Applies single template.
+cpl apply-template redis -a $APP_NAME
+
+# Applies several templates (practically creating full app).
+cpl apply-template gvc postgres redis rails -a $APP_NAME
+```
+
 ### `build-image`
 
 - Builds and pushes the image to Control Plane
 - Automatically assigns image numbers, e.g., `app:1`, `app:2`, etc.
-- Uses `.controlplane/Dockerfile`
+- Uses `.controlplane/Dockerfile` or a different Dockerfile specified through `dockerfile` in the `.controlplane/controlplane.yml` file
+- If a commit is provided through `--commit` or `-c`, it will be set as the runtime env var `GIT_COMMIT`
 
 ```sh
 cpl build-image -a $APP_NAME
@@ -143,6 +168,51 @@ cpl logs -a $APP_NAME
 cpl logs -a $APP_NAME -w $WORKLOAD_NAME
 ```
 
+### `maintenance`
+
+- Checks if maintenance mode is on or off for an app
+- Outputs 'on' or 'off'
+- Specify the one-off workload through `one_off_workload` in the `.controlplane/controlplane.yml` file
+- Optionally specify the maintenance workload through `maintenance_workload` in the `.controlplane/controlplane.yml` file (defaults to 'maintenance')
+- Maintenance mode is only supported for domains that use path based routing mode and have a route configured for the prefix '/' on either port 80 or 443
+
+```sh
+cpl maintenance -a $APP_NAME
+```
+
+### `maintenance:off`
+
+- Disables maintenance mode for an app
+- Specify the one-off workload through `one_off_workload` in the `.controlplane/controlplane.yml` file
+- Optionally specify the maintenance workload through `maintenance_workload` in the `.controlplane/controlplane.yml` file (defaults to 'maintenance')
+- Maintenance mode is only supported for domains that use path based routing mode and have a route configured for the prefix '/' on either port 80 or 443
+
+```sh
+cpl maintenance:off -a $APP_NAME
+```
+
+### `maintenance:on`
+
+- Enables maintenance mode for an app
+- Specify the one-off workload through `one_off_workload` in the `.controlplane/controlplane.yml` file
+- Optionally specify the maintenance workload through `maintenance_workload` in the `.controlplane/controlplane.yml` file (defaults to 'maintenance')
+- Maintenance mode is only supported for domains that use path based routing mode and have a route configured for the prefix '/' on either port 80 or 443
+
+```sh
+cpl maintenance:on -a $APP_NAME
+```
+
+### `maintenance:set-page`
+
+- Sets the page for maintenance mode
+- Only works if the maintenance workload uses the `shakacode/maintenance-mode` image
+- Will set the URL as an env var `PAGE_URL` on the maintenance workload
+- Optionally specify the maintenance workload through `maintenance_workload` in the `.controlplane/controlplane.yml` file (defaults to 'maintenance')
+
+```sh
+cpl maintenance:set-page PAGE_URL -a $APP_NAME
+```
+
 ### `open`
 
 - Opens the app endpoint URL in the default browser
@@ -220,6 +290,7 @@ cpl ps:stop -a $APP_NAME -w $WORKLOAD_NAME
 - Runs one-off **_interactive_** replicas (analog of `heroku run`)
 - Uses `Standard` workload type and `cpln exec` as the execution method, with CLI streaming
 - May not work correctly with tasks that last over 5 minutes (there's a Control Plane scaling bug at the moment)
+- If `fix_terminal_size` is `true` in the `.controlplane/controlplane.yml` file, the remote terminal size will be fixed to match the local terminal size (may also be overriden through `--terminal-size`)
 
 > **IMPORTANT:** Useful for development where it's needed for interaction, and where network connection drops and
 > task crashing are tolerable. For production tasks, it's better to use `cpl run:detached`.
@@ -228,6 +299,12 @@ cpl ps:stop -a $APP_NAME -w $WORKLOAD_NAME
 # Opens shell (bash by default).
 cpl run -a $APP_NAME
 
+# Need to quote COMMAND if setting ENV value or passing args.
+cpl run 'LOG_LEVEL=warn rails db:migrate' -a $APP_NAME
+
+# COMMAND may also be passed at the end (in this case, no need to quote).
+cpl run -a $APP_NAME -- rails db:migrate
+
 # Runs command, displays output, and exits shell.
 cpl run ls / -a $APP_NAME
 cpl run rails db:migrate:status -a $APP_NAME
@@ -238,6 +315,24 @@ cpl run rails c -a $APP_NAME
 # Uses a different image (which may not be promoted yet).
 cpl run rails db:migrate -a $APP_NAME --image appimage:123 # Exact image name
 cpl run rails db:migrate -a $APP_NAME --image latest       # Latest sequential image
+
+# Uses a different workload than `one_off_workload` from `.controlplane/controlplane.yml`.
+cpl run bash -a $APP_NAME -w other-workload
+
+# Overrides remote CPLN_TOKEN env variable with local token.
+# Useful when superuser rights are needed in remote container.
+cpl run bash -a $APP_NAME --use-local-token
+```
+
+### `run:cleanup`
+
+- Deletes stale run workloads for an app
+- Workloads are considered stale based on how many days since created
+- `stale_run_workload_created_days` in the `.controlplane/controlplane.yml` file specifies the number of days after created that the workload is considered stale
+- Will ask for explicit user confirmation of deletion
+
+```sh
+cpl run:cleanup -a $APP_NAME
 ```
 
 ### `run:detached`
@@ -251,9 +346,12 @@ cpl run rails db:migrate -a $APP_NAME --image latest       # Latest sequential i
 ```sh
 cpl run:detached rails db:prepare -a $APP_NAME
 
-# Need to quote COMMAND if setting ENV value or passing args to command to run
+# Need to quote COMMAND if setting ENV value or passing args.
 cpl run:detached 'LOG_LEVEL=warn rails db:migrate' -a $APP_NAME
 
+# COMMAND may also be passed at the end (in this case, no need to quote).
+cpl run:detached -a $APP_NAME -- rails db:migrate
+
 # Uses some other image.
 cpl run:detached rails db:migrate -a $APP_NAME --image /some/full/image/path
 
@@ -263,30 +361,19 @@ cpl run:detached rails db:migrate -a $APP_NAME --image latest
 # Uses a different image (which may not be promoted yet).
 cpl run:detached rails db:migrate -a $APP_NAME --image appimage:123 # Exact image name
 cpl run:detached rails db:migrate -a $APP_NAME --image latest       # Latest sequential image
+
+# Uses a different workload than `one_off_workload` from `.controlplane/controlplane.yml`.
+cpl run:detached rails db:migrate:status -a $APP_NAME -w other-workload
 ```
 
-### `setup`
+### `setup-app`
 
-- Applies application-specific configs from templates (e.g., for every review-app)
-- Publishes (creates or updates) those at Control Plane infrastructure
-- Picks templates from the `.controlplane/templates` directory
-- Templates are ordinary Control Plane templates but with variable preprocessing
-
-**Preprocessed template variables:**
-
-```
-APP_GVC      - basically GVC or app name
-APP_LOCATION - default location
-APP_ORG      - organization
-APP_IMAGE    - will use latest app image
-```
+- Creates an app and all its workloads
+- Specify the templates for the app and workloads through `setup` in the `.controlplane/controlplane.yml` file
+- This should should only be used for temporary apps like review apps, never for persistent apps like production (to update workloads for those, use 'cpl apply-template' instead)
 
 ```sh
-# Applies single template.
-cpl setup redis -a $APP_NAME
-
-# Applies several templates (practically creating full app).
-cpl setup gvc postgres redis rails -a $APP_NAME
+cpl setup-app -a $APP_NAME
 ```
 
 ### `version`

data/examples/circleci.yml

@@ -66,7 +66,7 @@ build-review-app:
         name: Provision review app if needed
         command: |
           if ! cpl exist -a ${APP_NAME}; then
-            cpl setup gvc postgres redis memcached rails sidekiq -a ${APP_NAME}
+            cpl setup-app -a ${APP_NAME}
             echo "export NEW_APP=true" >> $BASH_ENV
           fi
     - run:

data/examples/controlplane.yml

@@ -23,6 +23,9 @@ aliases:
       - postgres
       - memcached
 
+    # Configure the workload name used when maintenance mode is on (defaults to 'maintenance')
+    maintenance_workload: maintenance
+
 apps:
   my-app-staging:
     # Use the values from the common section above

data/lib/command/{setup.rb → apply_template.rb}

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
 module Command
-  class Setup < Base
-    NAME = "setup"
-    USAGE = "setup TEMPLATE [TEMPLATE] ... [TEMPLATE]"
+  class ApplyTemplate < Base # rubocop:disable Metrics/ClassLength
+    NAME = "apply-template"
+    USAGE = "apply-template TEMPLATE [TEMPLATE] ... [TEMPLATE]"
     REQUIRES_ARGS = true
     OPTIONS = [
-      app_option(required: true)
+      app_option(required: true),
+      skip_confirm_option
     ].freeze
     DESCRIPTION = "Applies application-specific configs from templates"
     LONG_DESCRIPTION = <<~DESC
@@ -27,28 +28,35 @@ module Command
     EXAMPLES = <<~EX
       ```sh
       # Applies single template.
-      cpl setup redis -a $APP_NAME
+      cpl apply-template redis -a $APP_NAME
 
       # Applies several templates (practically creating full app).
-      cpl setup gvc postgres redis rails -a $APP_NAME
+      cpl apply-template gvc postgres redis rails -a $APP_NAME
       ```
     EX
 
     def call # rubocop:disable Metrics/MethodLength
+      ensure_templates!
+
       @app_status = :existing
       @created_workloads = []
       @failed_workloads = []
+      @skipped_workloads = []
 
-      config.args.each do |template|
-        filename = "#{config.app_cpln_dir}/templates/#{template}.yml"
+      @asked_for_confirmation = false
 
-        step("Applying template '#{template}'", abort_on_error: false) do
-          unless File.exist?(filename)
-            report_failure(template)
+      pending_templates = templates.select do |template|
+        if template == "gvc"
+          confirm_app(template)
+        else
+          confirm_workload(template)
+        end
+      end
 
-            raise "Can't find template '#{template}' at '#{filename}', please create it."
-          end
+      progress.puts if @asked_for_confirmation
 
+      pending_templates.each do |template, filename|
+        step("Applying template '#{template}'", abort_on_error: false) do
           apply_template(filename)
           if $CHILD_STATUS.success?
             report_success(template)
@@ -63,10 +71,58 @@ module Command
       print_app_status
       print_created_workloads
       print_failed_workloads
+      print_skipped_workloads
     end
 
     private
 
+    def templates
+      @templates ||= config.args.to_h do |template|
+        [template, "#{config.app_cpln_dir}/templates/#{template}.yml"]
+      end
+    end
+
+    def ensure_templates!
+      missing_templates = templates.filter { |_template, filename| !File.exist?(filename) }.to_h
+      return if missing_templates.empty?
+
+      missing_templates_str = missing_templates.map do |template, filename|
+        "  - #{template} (#{filename})"
+      end.join("\n")
+      progress.puts("#{Shell.color('Missing templates:', :red)}\n#{missing_templates_str}\n\n")
+
+      raise "Can't find templates above, please create them."
+    end
+
+    def confirm_apply(message)
+      return true if config.options[:yes]
+
+      @asked_for_confirmation = true
+      Shell.confirm(message)
+    end
+
+    def confirm_app(template)
+      app = cp.fetch_gvc
+      return true unless app
+
+      confirmed = confirm_apply("App '#{config.app}' already exists, do you want to re-create it?")
+      return true if confirmed
+
+      report_skipped(template)
+      false
+    end
+
+    def confirm_workload(template)
+      workload = cp.fetch_workload(template)
+      return true unless workload
+
+      confirmed = confirm_apply("Workload '#{template}' already exists, do you want to re-create it?")
+      return true if confirmed
+
+      report_skipped(template)
+      false
+    end
+
     def apply_template(filename)
       data = File.read(filename)
                  .gsub("APP_GVC", config.app)
@@ -93,13 +149,24 @@ module Command
       end
     end
 
+    def report_skipped(template)
+      if template == "gvc"
+        @app_status = :skipped
+      else
+        @skipped_workloads.push(template)
+      end
+    end
+
     def print_app_status
       return if @app_status == :existing
 
-      if @app_status == :success
+      case @app_status
+      when :success
         progress.puts("\n#{Shell.color("Created app '#{config.app}'.", :green)}")
-      else
+      when :failure
         progress.puts("\n#{Shell.color("Failed to create app '#{config.app}'.", :red)}")
+      when :skipped
+        progress.puts("\n#{Shell.color("Skipped app '#{config.app}' (already exists).", :blue)}")
       end
     end
 
@@ -116,5 +183,12 @@ module Command
       workloads = @failed_workloads.map { |template| "  - #{template}" }.join("\n")
       progress.puts("\n#{Shell.color('Failed to create workloads:', :red)}\n#{workloads}")
     end
+
+    def print_skipped_workloads
+      return unless @skipped_workloads.any?
+
+      workloads = @skipped_workloads.map { |template| "  - #{template}" }.join("\n")
+      progress.puts("\n#{Shell.color('Skipped workloads (already exist):', :blue)}\n#{workloads}")
+    end
   end
 end