You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The Site CRD is the primary resource for managing a complete Posit Team deployment. It orchestrates all product components (Connect, Workbench, Package Manager, Chronicle) in a single site.
Kind:SitePlural:sitesScope: Namespaced
Spec Fields
Field
Type
Required
Description
.spec.domain
string
Yes
The core domain name for the Posit Team Site
.spec.awsAccountId
string
No
AWS Account ID used for EKS-to-IAM annotations
.spec.clusterDate
string
No
Cluster date ID (YYYYmmdd) used for EKS-to-IAM annotations
.spec.workloadCompoundName
string
No
Name for the workload
.spec.secretType
SiteSecretType
No
DEPRECATED - Type of secret management to use
.spec.ingressClass
string
No
Ingress class for creating ingress routes
.spec.ingressAnnotations
map[string]string
No
Annotations applied to all ingress routes
.spec.imagePullSecrets
[]string
No
Image pull secrets for all image pulls (secrets must exist in namespace)
The Connect CRD manages standalone Posit Connect deployments. When using the Site CRD, specify Connect configuration through .spec.connect instead of creating a separate Connect resource.
The Workbench CRD manages standalone Posit Workbench deployments. When using the Site CRD, specify Workbench configuration through .spec.workbench instead of creating a separate Workbench resource.
The PackageManager CRD manages standalone Posit Package Manager deployments. When using the Site CRD, specify Package Manager configuration through .spec.packageManager instead of creating a separate PackageManager resource.
Authentication configuration used by Connect and Workbench.
Field
Type
Description
.type
AuthType
Authentication type: password, oidc, or saml
.clientId
string
OAuth2/OIDC client ID
.issuer
string
OIDC issuer URL
.groups
bool
Enable group synchronization
.usernameClaim
string
OIDC claim for username
.emailClaim
string
OIDC claim for email
.uniqueIdClaim
string
OIDC claim for unique ID
.groupsClaim
string
OIDC claim for groups
.disableGroupsClaim
bool
Disable groups claim processing
.samlMetadataUrl
string
SAML IdP metadata URL
.samlIdPAttributeProfile
string
SAML IdP attribute profile
.samlUsernameAttribute
string
SAML attribute for username
.samlFirstNameAttribute
string
SAML attribute for first name
.samlLastNameAttribute
string
SAML attribute for last name
.samlEmailAttribute
string
SAML attribute for email
.scopes
[]string
Additional OIDC scopes
.viewerRoleMapping
[]string
Groups mapped to viewer role
.publisherRoleMapping
[]string
Groups mapped to publisher role
.administratorRoleMapping
[]string
Groups mapped to administrator role
AuthType Values:
Value
Description
password
Local username/password authentication
oidc
OpenID Connect authentication
saml
SAML 2.0 authentication
SecretConfig
Secret management configuration.
Field
Type
Description
.vaultName
string
Name of the secret vault/secret
.type
SiteSecretType
Secret management type
SiteSecretType Values:
Value
Description
kubernetes
Use Kubernetes Secrets
aws
Use AWS Secrets Manager with CSI driver
test
Test mode (in-memory)
VolumeSource
Source configuration for persistent volumes.
Field
Type
Description
.type
VolumeSourceType
Volume source type
.volumeId
string
Volume identifier (e.g., FSx volume ID)
.dnsName
string
DNS name for volume access
VolumeSourceType Values:
Value
Description
fsx-zfs
Amazon FSx for OpenZFS
nfs
NFS server
azure-netapp
Azure NetApp Files
VolumeSpec
Specification for creating or mounting a PersistentVolumeClaim.
Field
Type
Description
.create
bool
Whether to create the PVC
.accessModes
[]string
Access modes (when creating)
.volumeName
string
PV name to reference (when creating)
.storageClassName
string
Storage class name (when creating)
.size
string
PVC size (when creating)
.pvcName
string
Existing PVC name (when not creating)
.mountPath
string
Mount path for additional volumes
.readOnly
bool
Mount as read-only (default: false)
LicenseSpec
Product license configuration.
Field
Type
Description
.type
LicenseType
License type
.key
string
License key (for KEY type)
.existingSecretName
string
Name of existing secret containing license
.existingSecretKey
string
Key within the secret (default: "license.lic")
LicenseType Values:
Value
Description
KEY
License key string
FILE
License file
SessionConfig
Session pod configuration (Connect and Workbench).
Field
Type
Description
.service
ServiceConfig
Service configuration for sessions
.pod
PodConfig
Pod configuration for sessions
.job
JobConfig
Job configuration for sessions
ServiceConfig:
Field
Type
Description
.type
string
Kubernetes service type
.annotations
map[string]string
Service annotations
.labels
map[string]string
Service labels
PodConfig:
Field
Type
Description
.annotations
map[string]string
Pod annotations
.labels
map[string]string
Pod labels
.serviceAccountName
string
Service account for pods
.volumes
[]Volume
Additional volumes
.volumeMounts
[]VolumeMount
Additional volume mounts
.env
[]EnvVar
Environment variables
.imagePullPolicy
PullPolicy
Image pull policy
.imagePullSecrets
[]LocalObjectReference
Image pull secrets
.initContainers
[]Container
Init containers
.extraContainers
[]Container
Sidecar containers
.containerSecurityContext
SecurityContext
Container security context
.tolerations
[]Toleration
Pod tolerations
.affinity
*Affinity
Pod affinity rules
.nodeSelector
map[string]string
Node selector
.priorityClassName
string
Priority class name
.command
[]string
Override container command
SSHKeyConfig
SSH key configuration for Git authentication in Package Manager.
Field
Type
Required
Description
.name
string
Yes
Unique identifier (1-63 chars, lowercase alphanumeric with hyphens)
.host
string
Yes
Git host domain (e.g., "github.com")
.secretRef
SecretReference
Yes
Reference to the SSH key secret
.passphraseSecretRef
*SecretReference
No
Reference to passphrase secret for encrypted keys
SecretReference:
Field
Type
Required
Description
.source
string
Yes
Secret source: aws-secrets-manager, kubernetes, or azure-key-vault
.name
string
Yes
Secret name in the specified source
.key
string
No
Key within the secret (primarily for Kubernetes secrets)
Site Internal Specs
These types are used within the Site CRD for product configuration.
InternalFlightdeckSpec
Field
Type
Description
.enabled
*bool
Enable Flightdeck (default: true)
.image
string
Container image
.imagePullPolicy
PullPolicy
Image pull policy
.replicas
int
Number of replicas
.featureEnabler
FeatureEnablerConfig
Feature toggles
.logLevel
string
Log level (default: "info")
.logFormat
string
Log format (default: "text")
InternalPackageManagerSpec
Field
Type
Description
.license
LicenseSpec
License configuration
.volume
*VolumeSpec
Data volume
.nodeSelector
map[string]string
Node selector
.addEnv
map[string]string
Environment variables
.image
string
Container image
.imagePullPolicy
PullPolicy
Image pull policy
.s3Bucket
string
S3 bucket for package storage
.replicas
int
Number of replicas
.domainPrefix
string
Domain prefix (default: "packagemanager")
.gitSSHKeys
[]SSHKeyConfig
SSH keys for Git authentication
.azureFiles
*AzureFilesConfig
Azure Files configuration
InternalConnectSpec
Field
Type
Description
.enabled
*bool
Controls whether Connect runs (default: true). Setting to false suspends Connect: stops pods and removes ingress/service, but preserves PVC, database, and secrets. Re-enabling restores full service without data loss. See Connect Configuration Guide.
.teardown
*bool
When true and enabled is false, destroys all Connect resources including database, secrets, and PVC. Re-enabling after teardown starts fresh with an empty database. Defaults to false.
.license
LicenseSpec
License configuration
.volume
*VolumeSpec
Data volume
.nodeSelector
map[string]string
Node selector
.auth
AuthSpec
Authentication configuration
.addEnv
map[string]string
Environment variables
.image
string
Container image
.sessionImage
string
Session container image
.imagePullPolicy
PullPolicy
Image pull policy
.databricks
*DatabricksConfig
Databricks integration
.loggedInWarning
string
Warning message for logged-in users
.publicWarning
string
Public warning message
.replicas
int
Number of replicas
.experimentalFeatures
*InternalConnectExperimentalFeatures
Experimental features
.domainPrefix
string
Domain prefix (default: "connect")
.gpuSettings
*GPUSettings
GPU resource configuration
.databaseSettings
*DatabaseSettings
Database schema settings
.scheduleConcurrency
int
Schedule concurrency (default: 2)
InternalWorkbenchSpec
Field
Type
Description
.databricks
map[string]DatabricksConfig
Databricks configurations
.snowflake
SnowflakeConfig
Snowflake configuration
.license
LicenseSpec
License configuration
.volume
*VolumeSpec
Home directory volume
.additionalVolumes
[]VolumeSpec
Additional volumes
.nodeSelector
map[string]string
Node selector
.tolerations
[]Toleration
Pod tolerations
.sessionTolerations
[]Toleration
Session-only tolerations
.createUsersAutomatically
bool
Auto-create users
.adminGroups
[]string
Admin groups (default: ["workbench-admin"])
.adminSuperuserGroups
[]string
Superuser groups
.addEnv
map[string]string
Environment variables
.auth
AuthSpec
Authentication configuration
.image
string
Container image
.imagePullPolicy
PullPolicy
Image pull policy
.defaultSessionImage
string
Default session image
.extraSessionImages
[]string
Additional session images
.sessionInitContainerImageName
string
Init container image name
.sessionInitContainerImageTag
string
Init container image tag
.replicas
int
Number of replicas
.experimentalFeatures
*InternalWorkbenchExperimentalFeatures
Experimental features
.vsCodeExtensions
[]string
VS Code extensions to install
.vsCodeUserSettings
map[string]*JSON
VS Code user settings
.positronConfig
PositronConfig
Positron configuration
.vsCodeConfig
VSCodeConfig
VS Code configuration
.apiSettings
ApiSettingsConfig
API settings
.domainPrefix
string
Domain prefix (default: "workbench")
.authLoginPageHtml
string
Custom login page HTML
.jupyterConfig
*WorkbenchJupyterConfig
Jupyter configuration
InternalChronicleSpec
Field
Type
Description
.nodeSelector
map[string]string
Node selector
.image
string
Container image
.addEnv
map[string]string
Environment variables
.imagePullPolicy
PullPolicy
Image pull policy
.s3Bucket
string
S3 bucket for storage
.agentImage
string
Agent container image
Labels Applied by the Operator
The Team Operator applies the following labels to managed resources: