Skip to main content
Version: v0.23 (EOS)

Platform

Enterprise-Only Feature

This feature is an Enterprise feature. See our pricing plans or contact our sales team for more information.

You can connect to vCluster Platform through the vcluster.yaml and configure different vCluster Platform settings that work with the virtual cluster.

Example​

With this example, you can set the vCluster to automatically sleep after 10 minutes.

external:
  platform:
    autoSleep:
      schedule: * 17 * * * # Sleep at 5 PM
      autoWakeup:
        schedule: * 9 * * * # Wakeup at 9 AM

Config reference​

platform required object ​

platform holds platform configuration

apiKey required object ​

APIKey defines where to find the platform access key and host. By default, vCluster will search in the following locations in this precedence:

  • environment variable called LICENSE
  • secret specified under external.platform.apiKey.secretName
  • secret called "vcluster-platform-api-key" in the vCluster namespace

secretName required string ​

SecretName is the name of the secret where the platform access key is stored. This defaults to vcluster-platform-api-key if undefined.

namespace required string ​

Namespace defines the namespace where the access key secret should be retrieved from. If this is not equal to the namespace where the vCluster instance is deployed, you need to make sure vCluster has access to this other namespace.

createRBAC required boolean ​

CreateRBAC will automatically create the necessary RBAC roles and role bindings to allow vCluster to read the secret specified in the above namespace, if specified. This defaults to true.

autoSleep required object ​

AutoSleep holds configuration for automatic sleep and wakeup

afterInactivity required integer ​

AfterInactivity specifies after how many seconds of inactivity the virtual cluster should sleep

schedule required string ​

Schedule specifies scheduled virtual cluster sleep in Cron format, see https://en.wikipedia.org/wiki/Cron. Note: timezone defined in the schedule string will be ignored. Use ".Timezone" field instead.

timezone required string ​

Timezone specifies time zone used for scheduled virtual cluster operations. Defaults to UTC. Accepts the same format as time.LoadLocation() in Go (https://pkg.go.dev/time#LoadLocation). The value should be a location name corresponding to a file in the IANA Time Zone database, such as "America/New_York".

autoWakeup required object ​

AutoSleep holds configuration for automatic wakeup

schedule required string ​

Schedule specifies scheduled wakeup from sleep in Cron format, see https://en.wikipedia.org/wiki/Cron. Note: timezone defined in the schedule string will be ignored. The timezone for the autoSleep schedule will be used

autoDelete required object ​

AutoDelete holds configuration for automatic delete

afterInactivity required integer ​

AfterInactivity specifies after how many seconds of inactivity the virtual cluster be deleted

project required string ​

Project specifies which platform project the vcluster should be imported to.