Configuration reference

This page describes all configurable fields in the piped configuration.
apiVersion: pipecd.dev/v1beta1
kind: Piped
spec:
  projectID: ...
  pipedID: ...
  ...

Piped Configuration

Field Type Description Required
projectID string The identifier of the PipeCD project where this piped belongs to. Yes
pipedID string The generated ID for this piped. Yes
pipedKeyFile string The path to the file containing the generated key string for this piped. Yes
pipedKeyData string Base64 encoded string of Piped key. Either pipedKeyFile or pipedKeyData must be set. Yes
apiAddress string The address used to connect to the Control Plane’s API in format host:port. Yes
syncInterval duration How often to check whether an application should be synced. Default is 1m. No
appConfigSyncInterval duration How often to check whether application configuration files should be synced. Default is 1m. No
git Git Git configuration needed for Git commands. No
repositories []Repository List of Git repositories this piped will handle. No
chartRepositories []ChartRepository List of Helm chart repositories that should be added while starting up. No
chartRegistries []ChartRegistry List of helm chart registries that should be logged in while starting up. No
cloudProviders []CloudProvider List of cloud providers can be used by this piped. This field is deprecated, use platformProviders instead. No
platformProviders []PlatformProvider List of platform providers can be used by this piped. No
analysisProviders []AnalysisProvider List of analysis providers can be used by this piped. No
eventWatcher EventWatcher Optional Event watcher settings. No
secretManagement SecretManagement The using secret management method. No
notifications Notifications Sending notifications to Slack, Webhook… No
appSelector map[string]string List of labels to filter all applications this piped will handle. Currently, it is only be used to filter the applications suggested for adding from the control plane. No

Git

Field Type Description Required
username string The username that will be configured for git user. Default is piped. No
email string The email that will be configured for git user. Default is pipecd.dev@gmail.com. No
sshConfigFilePath string Where to write ssh config file. Default is $HOME/.ssh/config. No
host string The host name. Default is github.com. No
hostName string The hostname or IP address of the remote git server. Default is the same value with Host. No
sshKeyFile string The path to the private ssh key file. This will be used to clone the source code of the specified git repositories. No
sshKeyData string Base64 encoded string of SSH key. No

GitRepository

Field Type Description Required
repoID string Unique identifier to the repository. This must be unique in the piped scope. Yes
remote string Remote address of the repository used to clone the source code. e.g. git@github.com:org/repo.git Yes
branch string The branch will be handled. Yes

ChartRepository

Field Type Description Required
type string The repository type. Currently, HTTP and GIT are supported. Default is HTTP. No
name string The name of the Helm chart repository. Note that is not a Git repository but a Helm chart repository. Yes if type is HTTP
address string The address to the Helm chart repository. Yes if type is HTTP
username string Username used for the repository backed by HTTP basic authentication. No
password string Password used for the repository backed by HTTP basic authentication. No
insecure bool Whether to skip TLS certificate checks for the repository or not. No
gitRemote string Remote address of the Git repository used to clone Helm charts. Yes if type is GIT
sshKeyFile string The path to the private ssh key file used while cloning Helm charts from above Git repository. No

ChartRegistry

Field Type Description Required
type string The registry type. Currently, only OCI is supported. Default is OCI. No
address string The address to the registry. Yes
username string Username used for the registry authentication. No
password string Password used for the registry authentication. No

CloudProvider

Field Type Description Required
name string The name of the cloud provider. Yes
type string The cloud provider type. Must be one of the following values:
KUBERNETES, TERRAFORM, CLOUDRUN, LAMBDA.
Yes
config CloudProviderConfig Specific configuration for the specified type of cloud provider. No

CloudProviderConfig

Must be one of the following structs:

CloudProviderKubernetesConfig

Field Type Description Required
masterURL string The master URL of the kubernetes cluster. Empty means in-cluster. No
kubeConfigPath string The path to the kubeconfig file. Empty means in-cluster. No
appStateInformer KubernetesAppStateInformer Configuration for application resource informer. No

CloudProviderTerraformConfig

Field Type Description Required
vars []string List of variables that will be set directly on terraform commands with -var flag. The variable must be formatted by key=value. No

CloudProviderCloudRunConfig

Field Type Description Required
project string The GCP project hosting the Cloud Run service. Yes
region string The region of running Cloud Run service. Yes
credentialsFile string The path to the service account file for accessing Cloud Run service. No

CloudProviderLambdaConfig

Field Type Description Required
region string The region of running Lambda service. Yes
credentialsFile string The path to the credential file for logging into AWS cluster. If this value is not provided, piped will read credential info from environment variables. It expects the format ~/.aws/credentials. No
roleARN string The IAM role arn to use when assuming an role. Required if you want to use the AWS SecurityTokenService. No
tokenFile string The path to the WebIdentity token the SDK should use to assume a role with. Required if you want to use the AWS SecurityTokenService. No
profile string The profile to use for logging into AWS cluster. The default value is default. No

CloudProviderECSConfig

Field Type Description Required
region string The region of running ECS cluster. Yes
credentialsFile string The path to the credential file for logging into AWS cluster. If this value is not provided, piped will read credential info from environment variables. It expects the format ~/.aws/credentials No
roleARN string The IAM role arn to use when assuming an role. Required if you want to use the AWS SecurityTokenService. No
tokenFile string The path to the WebIdentity token the SDK should use to assume a role with. Required if you want to use the AWS SecurityTokenService. No
profile string The profile to use for logging into AWS cluster. The default value is default. No

PlatformProvider

Field Type Description Required
name string The name of the platform provider. Yes
type string The platform provider type. Must be one of the following values:
KUBERNETES, TERRAFORM, CLOUDRUN, LAMBDA.
Yes
config PlatformProviderConfig Specific configuration for the specified type of platform provider. No

PlatformProviderConfig

Must be one of the following structs:

PlatformProviderKubernetesConfig

Field Type Description Required
masterURL string The master URL of the kubernetes cluster. Empty means in-cluster. No
kubeConfigPath string The path to the kubeconfig file. Empty means in-cluster. No
appStateInformer KubernetesAppStateInformer Configuration for application resource informer. No

PlatformProviderTerraformConfig

Field Type Description Required
vars []string List of variables that will be set directly on terraform commands with -var flag. The variable must be formatted by key=value. No

PlatformProviderCloudRunConfig

Field Type Description Required
project string The GCP project hosting the Cloud Run service. Yes
region string The region of running Cloud Run service. Yes
credentialsFile string The path to the service account file for accessing Cloud Run service. No

PlatformProviderLambdaConfig

Field Type Description Required
region string The region of running Lambda service. Yes
credentialsFile string The path to the credential file for logging into AWS cluster. If this value is not provided, piped will read credential info from environment variables. It expects the format ~/.aws/credentials. No
roleARN string The IAM role arn to use when assuming an role. Required if you want to use the AWS SecurityTokenService. No
tokenFile string The path to the WebIdentity token the SDK should use to assume a role with. Required if you want to use the AWS SecurityTokenService. No
profile string The profile to use for logging into AWS cluster. The default value is default. No

PlatformProviderECSConfig

Field Type Description Required
region string The region of running ECS cluster. Yes
credentialsFile string The path to the credential file for logging into AWS cluster. If this value is not provided, piped will read credential info from environment variables. It expects the format ~/.aws/credentials No
roleARN string The IAM role arn to use when assuming an role. Required if you want to use the AWS SecurityTokenService. No
tokenFile string The path to the WebIdentity token the SDK should use to assume a role with. Required if you want to use the AWS SecurityTokenService. No
profile string The profile to use for logging into AWS cluster. The default value is default. No

KubernetesAppStateInformer

Field Type Description Required
namespace string Only watches the specified namespace. Empty means watching all namespaces. No
includeResources []KubernetesResourcematcher List of resources that should be added to the watching targets. No
excludeResources []KubernetesResourcematcher List of resources that should be ignored from the watching targets. No

KubernetesResourceMatcher

Field Type Description Required
apiVersion string The APIVersion of the kubernetes resource. Yes
kind string The kind name of the kubernetes resource. Empty means all kinds are matching. No

AnalysisProvider

Field Type Description Required
name string The unique name of the analysis provider. Yes
type string The provider type. Currently, only PROMETHEUS, DATADOG are available. Yes
config AnalysisProviderConfig Specific configuration for the specified type of analysis provider. Yes

AnalysisProviderConfig

Must be one of the following structs:

AnalysisProviderPrometheusConfig

Field Type Description Required
address string The Prometheus server address. Yes
usernameFile string The path to the username file. No
passwordFile string The path to the password file. No

AnalysisProviderDatadogConfig

Field Type Description Required
address string The address of Datadog API server. Only “datadoghq.com”, “us3.datadoghq.com”, “datadoghq.eu”, “ddog-gov.com” are available. Defaults to “datadoghq.com” No
apiKeyFile string The path to the api key file. Yes
applicationKeyFile string The path to the application key file. Yes

EventWatcher

Field Type Description Required
checkInterval duration Interval to fetch the latest event and compare it with one defined in EventWatcher config files. Defaults to 1m. No
gitRepos []EventWatcherGitRepo The configuration list of git repositories to be observed. Only the repositories in this list will be observed by Piped. No

EventWatcherGitRepo

Field Type Description Required
repoId string Id of the git repository. This must be unique within the repos’ elements. Yes
commitMessage string The commit message used to push after replacing values. Default message is used if not given. No
includes []string The paths to EventWatcher files to be included. Patterns can be used like foo/*.yaml. No
excludes []string The paths to EventWatcher files to be excluded. Patterns can be used like foo/*.yaml. This is prioritized if both includes and this are given. No

SecretManagement

Field Type Description Required
type string Which management method should be used. Default is KEY_PAIR. Yes
config SecretManagementConfig Configration for using secret management method. Yes

SecretManagementConfig

Must be one of the following structs:

SecretManagementKeyPair

Field Type Description Required
privateKeyFile string Path to the private RSA key file. Yes
privateKeyData string Base64 encoded string of private RSA key. Either privateKeyFile or privateKeyData must be set. No
publicKeyFile string Path to the public RSA key file. Yes
publicKeyData string Base64 encoded string of public RSA key. Either publicKeyFile or publicKeyData must be set. No

SecretManagementGCPKMS

WIP

Notifications

Field Type Description Required
routes []NotificationRoute List of notification routes. No
receivers []NotificationReceiver List of notification receivers. No

NotificationRoute

Field Type Description Required
name string The name of the route. Yes
receiver string The name of receiver who will receive all matched events. Yes
events []string List of events that should be routed to the receiver. No
ignoreEvents []string List of events that should be ignored. No
groups []string List of event groups should be routed to the receiver. No
ignoreGroups []string List of event groups should be ignored. No
apps []string List of applications where their events should be routed to the receiver. No
ignoreApps []string List of applications where their events should be ignored. No
labels map[string]string List of labels where their events should be routed to the receiver. No
ignoreLabels map[string]string List of labels where their events should be ignored. No

NotificationReceiver

Field Type Description Required
name string The name of the receiver. Yes
slack NotificationReciverSlack Configuration for slack receiver. No
webhook NotificationReceiverWebhook Configuration for webhook receiver. No

NotificationReceiverSlack

Field Type Description Required
hookURL string The hookURL of a slack channel. Yes

NotificationReceiverWebhook

Field Type Description Required
url string The URL where notification event will be sent to. Yes
signatureKey string The HTTP header key used to store the configured signature in each event. Default is “PipeCD-Signature”. No
signatureValue string The value of signature included in header of each event request. It can be used to verify the received events. No
signatureValueFile string The path to the signature value file. No

Last modified December 9, 2022: fix description of apiAddress (#4064) (e8547ae3)