Document operator configuration parameters. (#313)
This commit is contained in:
Oleksii Kliukin
GitHub
parent
c26962ba62
commit
9cb48e0889
|
|
@ -0,0 +1,306 @@
|
||||||
|
Postgres Operator Configuration
|
||||||
|
===============================
|
||||||
|
|
||||||
|
Postgres operator is configured via a ConfigMap defined by the
|
||||||
|
`CONFIG_MAP_NAME` environment variable. Variable names are underscore-separated
|
||||||
|
words.
|
||||||
|
|
||||||
|
Available Configuration Parameters
|
||||||
|
----------------------------------
|
||||||
|
|
||||||
|
### General
|
||||||
|
* **etcd_host**
|
||||||
|
Etcd connection string for Patroni defined as `host:port`. Not required when
|
||||||
|
Patroni native Kubernetes support is used. The default is empty (use
|
||||||
|
Kubernetes-native DCS).
|
||||||
|
|
||||||
|
* **docker_image**
|
||||||
|
Spilo docker image for postgres instances. For production, don't rely on the
|
||||||
|
default image, as it might be not the most up-to-date one. Instead, build
|
||||||
|
your own Spilo image from the [github
|
||||||
|
repository](https://github.com/zalando/spilo).
|
||||||
|
|
||||||
|
* **workers**
|
||||||
|
number of working routines the operator spawns to process requests to
|
||||||
|
create/update/delete/sync clusters concurrently. The default is `4`.
|
||||||
|
|
||||||
|
* **max_instances**
|
||||||
|
operator will cap the number of instances in any managed postgres cluster up
|
||||||
|
to the value of this parameter. When `-1` is specified, no limits are applied.
|
||||||
|
The default is `-1`.
|
||||||
|
|
||||||
|
* **min_instances**
|
||||||
|
operator will run at least the number of instances for any given postgres
|
||||||
|
cluster equal to the value of this parameter. When `-1` is specified, no limits
|
||||||
|
are applied. The default is `-1`.
|
||||||
|
|
||||||
|
* **resync_period**
|
||||||
|
period between consecutive sync requests. The default is `5m`.
|
||||||
|
|
||||||
|
### Postgres users
|
||||||
|
* **super_username**
|
||||||
|
postgres `superuser` name to be created by `initdb`. The default is
|
||||||
|
`postgres`.
|
||||||
|
|
||||||
|
* **replication_username**
|
||||||
|
postgres username used for replication between instances. The default is
|
||||||
|
`standby`.
|
||||||
|
|
||||||
|
### Kubernetes resources
|
||||||
|
* **pod_service_account_name**
|
||||||
|
service account used by Patroni running on individual Pods to communicate
|
||||||
|
with the operator. Required even if native Kubernetes support in Patroni is
|
||||||
|
not used, because Patroni keeps pod labels in sync with the instance role.
|
||||||
|
The default is `operator`.
|
||||||
|
|
||||||
|
* **pod_service_account_definition**
|
||||||
|
The operator tries to create the pod Service Account in the namespace that
|
||||||
|
doesn't define such an account using the YAML definition provided by this
|
||||||
|
option. If not defined, a simple definition that contains only the name will
|
||||||
|
be used. The default is empty.
|
||||||
|
|
||||||
|
* **pod_terminate_grace_period**
|
||||||
|
Patroni pods are [terminated
|
||||||
|
forcefully](https://kubernetes.io/docs/concepts/workloads/pods/pod/#termination-of-pods)
|
||||||
|
after this timeout. The default is `5m`.
|
||||||
|
|
||||||
|
* **watched_namespace**
|
||||||
|
The operator watches for postgres objects in the given namespace. If not
|
||||||
|
specified, the value is taken from the operator namespace. A special `*`
|
||||||
|
value makes it watch all namespaces. The default is empty (watch the operator pod
|
||||||
|
namespace).
|
||||||
|
|
||||||
|
* **pdb_name_format**
|
||||||
|
defines the template for PDB (Pod Disruption Budget) names created by the
|
||||||
|
operator. The default is `postgres-{cluster}-pdb`, where `{cluster}` is
|
||||||
|
replaced by the cluster name. Only the `{cluster}` placeholders is allowed in
|
||||||
|
the template.
|
||||||
|
|
||||||
|
* **secret_name_template**
|
||||||
|
a template for the name of the database user secrets generated by the
|
||||||
|
operator. `{username}` is replaced with name of the secret, `{cluster}` with
|
||||||
|
the name of the cluster, `{tprkind}` with the kind of CRD (formerly known as
|
||||||
|
TPR) and `{tprgroup}` with the group of the CRD. No other placeholders are
|
||||||
|
allowed. The default is
|
||||||
|
`{username}.{cluster}.credentials.{tprkind}.{tprgroup}`.
|
||||||
|
|
||||||
|
* **oauth_token_secret_name**
|
||||||
|
a name of the secret containing the `OAuth2` token to pass to the teams API.
|
||||||
|
The default is `postgresql-operator`.
|
||||||
|
|
||||||
|
* **infrastructure_roles_secret_name**
|
||||||
|
name of the secret containing infrastructure roles names and passwords.
|
||||||
|
|
||||||
|
* **pod_role_label**
|
||||||
|
name of the label assigned to the postgres pods (and services/endpoints) by
|
||||||
|
the operator. The default is `spilo-role`.
|
||||||
|
|
||||||
|
* **cluster_labels**
|
||||||
|
list of `name:value` pairs for additional labels assigned to the cluster
|
||||||
|
objects. The default is `application:spilo`.
|
||||||
|
|
||||||
|
* **cluster_name_label**
|
||||||
|
name of the label assigned to Kubernetes objects created by the operator that
|
||||||
|
indicates which cluster a given object belongs to. The default is
|
||||||
|
`cluster-name`.
|
||||||
|
|
||||||
|
* **node_readiness_label**
|
||||||
|
a set of labels that a running and active node should possess to be
|
||||||
|
considered `ready`. The operator uses values of those labels to detect the
|
||||||
|
start of the Kubernetes cluster upgrade procedure and move master pods off
|
||||||
|
the nodes to be decommissioned. When the set is not empty, the operator also
|
||||||
|
assigns the `Affinity` clause to the postgres pods to be scheduled only on
|
||||||
|
`ready` nodes. The default is empty.
|
||||||
|
|
||||||
|
* **toleration**
|
||||||
|
a dictionary that should contain `key`, `operator`, `value` and
|
||||||
|
`effect` keys. In that case, the operator defines a pod toleration
|
||||||
|
according to the values of those keys. See [kubernetes
|
||||||
|
documentation](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/)
|
||||||
|
for details on taints and tolerations. The default is empty.
|
||||||
|
|
||||||
|
* **pod_environment_configmap**
|
||||||
|
a name of the ConfigMap with environment variables to populate on every pod.
|
||||||
|
Right now this ConfigMap is searched in the namespace of the postgres cluster.
|
||||||
|
All variables from that ConfigMap are injected to the pod's environment, on
|
||||||
|
conflicts they are overridden by the environment variables generated by the
|
||||||
|
operator. The default is empty.
|
||||||
|
|
||||||
|
### Kubernetes resource requests
|
||||||
|
* **default_cpu_request**
|
||||||
|
CPU request value for the postgres containers, unless overridden by
|
||||||
|
cluster-specific settings. The default is `100m`.
|
||||||
|
|
||||||
|
* **default_memory_request**
|
||||||
|
memory request value for the postgres containers, unless overridden by
|
||||||
|
cluster-specific settings. The default is `100Mi`.
|
||||||
|
|
||||||
|
* **default_cpu_limit**
|
||||||
|
CPU limits for the postgres containers, unless overridden by cluster-specific
|
||||||
|
settings. The default is `3`.
|
||||||
|
|
||||||
|
* **default_memory_limit**
|
||||||
|
memory limits for the postgres containers, unless overridden by cluster-specific
|
||||||
|
settings. The default is `1Gi`.
|
||||||
|
|
||||||
|
### Operator timeouts
|
||||||
|
* **resource_check_interval**
|
||||||
|
interval to wait between consecutive attempts to check for the presence of
|
||||||
|
some Kubernetes resource (i.e. `StatefulSet` or `PodDisruptionBudget`). The
|
||||||
|
default is `3s`.
|
||||||
|
|
||||||
|
* **resource_check_timeout**
|
||||||
|
timeout when waiting for the presence of a certain Kubernetes resource (i.e.
|
||||||
|
`StatefulSet` or `PodDisruptionBudget`) before declaring the operation
|
||||||
|
unsuccessful. The default is `10m`.
|
||||||
|
|
||||||
|
* **pod_label_wait_timeout**
|
||||||
|
timeout when waiting for the pod role and cluster labels. Bigger value gives
|
||||||
|
Patroni more time to start the instance; smaller makes the operator detect
|
||||||
|
possible issues faster. The default is `10m`.
|
||||||
|
|
||||||
|
* **pod_deletion_wait_timeout**
|
||||||
|
timeout when waiting for the pods to be deleted when removing the cluster or
|
||||||
|
recreating pods. The default is `10m`.
|
||||||
|
|
||||||
|
* **ready_wait_interval**
|
||||||
|
the interval between consecutive attempts waiting for the postgres CRD to be
|
||||||
|
created. The default is `5s`.
|
||||||
|
|
||||||
|
* **ready_wait_timeout**
|
||||||
|
the timeout for the complete postgres CRD creation. The default is `30s`.
|
||||||
|
|
||||||
|
### Load balancer related options
|
||||||
|
* **db_hosted_zone**
|
||||||
|
DNS zone for the cluster DNS name when the load balancer is configured for
|
||||||
|
the cluster. Only used when combined with
|
||||||
|
[external-dns](https://github.com/kubernetes-incubator/external-dns) and with
|
||||||
|
the cluster that has the load balancer enabled. The default is
|
||||||
|
`db.example.com`.
|
||||||
|
|
||||||
|
* **enable_master_load_balancer**
|
||||||
|
toggles service type load balancer pointing to the master pod of the cluster.
|
||||||
|
Can be overridden by individual cluster settings. The default is `true`.
|
||||||
|
|
||||||
|
* **enable_replica_load_balancer**
|
||||||
|
toggles service type load balancer pointing to the replica pod of the
|
||||||
|
cluster. Can be overridden by individual cluster settings. The default is
|
||||||
|
`false`.
|
||||||
|
|
||||||
|
* **master_dns_name_format** defines the DNS name string template for the
|
||||||
|
master load balancer cluster. The default is
|
||||||
|
`{cluster}.{team}.{hostedzone}`, where `{cluster}` is replaced by the cluster
|
||||||
|
name, `{team}` is replaced with the team name and `{hostedzone}` is replaced
|
||||||
|
with the hosted zone (the value of the `db_hosted_zone` parameter). No other
|
||||||
|
placeholders are allowed.
|
||||||
|
|
||||||
|
** **replica_dns_name_format** defines the DNS name string template for the
|
||||||
|
replica load balancer cluster. The default is
|
||||||
|
`{cluster}-repl.{team}.{hostedzone}`, where `{cluster}` is replaced by the
|
||||||
|
cluster name, `{team}` is replaced with the team name and `{hostedzone}` is
|
||||||
|
replaced with the hosted zone (the value of the `db_hosted_zone` parameter).
|
||||||
|
No other placeholders are allowed.
|
||||||
|
|
||||||
|
### AWS or GSC interaction
|
||||||
|
* **wal_s3_bucket**
|
||||||
|
S3 bucket to use for shipping WAL segments with WAL-E. A bucket has to be
|
||||||
|
present and accessible by Patroni managed pods. At the moment, supported
|
||||||
|
services by Spilo are S3 and GCS. The default is empty.
|
||||||
|
|
||||||
|
* **log_s3_bucket**
|
||||||
|
S3 bucket to use for shipping postgres daily logs. Works only with S3 on AWS.
|
||||||
|
The bucket has to be present and accessible by Patroni managed pods. At the
|
||||||
|
moment Spilo does not yet support this. The default is empty.
|
||||||
|
|
||||||
|
* **kube_iam_role**
|
||||||
|
AWS IAM role to supply in the `iam.amazonaws.com/role` annotation of Patroni
|
||||||
|
pods. Only used when combined with
|
||||||
|
[kube2iam](https://github.com/jtblin/kube2iam) project on AWS. The default is empty.
|
||||||
|
|
||||||
|
### Debugging the operator
|
||||||
|
* **debug_logging**
|
||||||
|
boolean parameter that toggles verbose debug logs from the operator. The
|
||||||
|
default is `true`.
|
||||||
|
|
||||||
|
* **enable_db_access**
|
||||||
|
boolean parameter that toggles the functionality of the operator that require
|
||||||
|
access to the postgres database, i.e. creating databases and users. The default
|
||||||
|
is `true`.
|
||||||
|
|
||||||
|
### Automatic creation of human users in the database
|
||||||
|
* **enable_teams_api**
|
||||||
|
boolean parameter that toggles usage of the Teams API by the operator.
|
||||||
|
The default is `true`.
|
||||||
|
|
||||||
|
* **teams_api_url**
|
||||||
|
contains the URL of the Teams API service. There is a [demo
|
||||||
|
implementation](https://github.com/ikitiki/fake-teams-api). The default is
|
||||||
|
`https://teams.example.com/api/`.
|
||||||
|
|
||||||
|
* **team_api_role_configuration**
|
||||||
|
postgres parameters to apply to each team member role. The default is
|
||||||
|
'*log_statement:all*'. It is possible to supply multiple options, separating
|
||||||
|
them by commas. Options containing commas within the value are not supported,
|
||||||
|
with the exception of the `search_path`. For instance:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
teams_api_role_configuration: "log_statement:all,search_path:'data,public'"
|
||||||
|
```
|
||||||
|
The default is `"log_statement:all"`
|
||||||
|
|
||||||
|
* **enable_team_superuser**
|
||||||
|
whether to grant superuser to team members created from the Teams API.
|
||||||
|
The default is `false`.
|
||||||
|
|
||||||
|
* **team_admin_role**
|
||||||
|
role name to grant to team members created from the Teams API. The default is
|
||||||
|
`admin`, that role is created by Spilo as a `NOLOGIN` role.
|
||||||
|
|
||||||
|
* **pam_role_name**
|
||||||
|
when set, the operator will add all team member roles to this group and add a
|
||||||
|
`pg_hba` line to authenticate members of that role via `pam`. The default is
|
||||||
|
`zalandos`.
|
||||||
|
|
||||||
|
* **pam_configuration**
|
||||||
|
when set, should contain a URL to use for authentication against the username
|
||||||
|
and the token supplied as the password. Used in conjunction with
|
||||||
|
[pam_oauth2](https://github.com/CyberDem0n/pam-oauth2) module. The default is
|
||||||
|
`https://info.example.com/oauth2/tokeninfo?access_token= uid
|
||||||
|
realm=/employees`.
|
||||||
|
|
||||||
|
* **protected_roles**
|
||||||
|
List of roles that cannot be overwritten by an application, team or
|
||||||
|
infrastructure role. The default is `admin`.
|
||||||
|
|
||||||
|
### Logging and REST API
|
||||||
|
* **api_port**
|
||||||
|
REST API listener listens to this port. The default is `8080`.
|
||||||
|
|
||||||
|
* **ring_log_lines**
|
||||||
|
number of lines in the ring buffer used to store cluster logs. The default is `100`.
|
||||||
|
|
||||||
|
* **cluster_history_entries**
|
||||||
|
number of entries in the cluster history ring buffer. The default is `1000`.
|
||||||
|
|
||||||
|
## Scalyr options
|
||||||
|
* **scalyr_api_key**
|
||||||
|
API key for the Scalyr sidecar. The default is empty.
|
||||||
|
|
||||||
|
* **scalyr_image**
|
||||||
|
Docker image for the Scalyr sidecar. The default is empty.
|
||||||
|
|
||||||
|
* **scalyr_server_url**
|
||||||
|
server URL for the Scalyr sidecar. The default is `https://upload.eu.scalyr.com`.
|
||||||
|
|
||||||
|
* **scalyr_cpu_request**
|
||||||
|
CPU request value for the Scalyr sidecar. The default is `100m`.
|
||||||
|
|
||||||
|
* **scalyr_memory_request**
|
||||||
|
Memory request value for the Scalyr sidecar. The default is `50Mi`.
|
||||||
|
|
||||||
|
* **scalyr_cpu_limit**
|
||||||
|
CPU limit value for the Scalyr sidecar. The default is `1`.
|
||||||
|
|
||||||
|
* **scalyr_memory_limit**
|
||||||
|
Memory limit value for the Scalyr sidecar. The default is `1Gi`.
|
||||||
|
|
||||||
|
|
@ -76,7 +76,6 @@ type Config struct {
|
||||||
// value of this string must be valid JSON or YAML; see initPodServiceAccount
|
// value of this string must be valid JSON or YAML; see initPodServiceAccount
|
||||||
PodServiceAccountDefinition string `name:"pod_service_account_definition" default:""`
|
PodServiceAccountDefinition string `name:"pod_service_account_definition" default:""`
|
||||||
DbHostedZone string `name:"db_hosted_zone" default:"db.example.com"`
|
DbHostedZone string `name:"db_hosted_zone" default:"db.example.com"`
|
||||||
EtcdScope string `name:"etcd_scope" default:"service"`
|
|
||||||
WALES3Bucket string `name:"wal_s3_bucket"`
|
WALES3Bucket string `name:"wal_s3_bucket"`
|
||||||
LogS3Bucket string `name:"log_s3_bucket"`
|
LogS3Bucket string `name:"log_s3_bucket"`
|
||||||
KubeIAMRole string `name:"kube_iam_role"`
|
KubeIAMRole string `name:"kube_iam_role"`
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue