### Install ACK on Different Clusters with Specific Services Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Example of creating cluster-specific values files and deploying ACK to different clusters with different service configurations. ```bash # Production cluster helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-cluster-prod.yaml \ --kubeconfig=$PROD_KUBECONFIG # Staging cluster helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-cluster-staging.yaml \ --kubeconfig=$STAGING_KUBECONFIG ``` -------------------------------- ### Monitoring and Observability Setup Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example values file for enabling monitoring and commands to install Prometheus and create ServiceMonitors. ```yaml # values.yaml with monitoring s3: enabled: true # Monitoring configuration (depends on controller support) # Check individual controller charts for monitoring options ``` ```bash # Install Prometheus for monitoring controllers helm install prometheus prometheus-community/kube-prometheus-stack \ -n monitoring # Create ServiceMonitor for ACK controllers kubectl apply -f service-monitors.yaml ``` -------------------------------- ### Installation from Latest Version Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Installs the latest available version of the ack-chart by first fetching the latest tag. ```bash # Get latest version tag export LATEST_VERSION=$(curl -sL https://api.github.com/repos/aws-controllers-k8s/ack-chart/releases/latest | grep '"tag_name":' | cut -d'"' -f4) # Install with latest version helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=$LATEST_VERSION \ --set s3.enabled=true ``` -------------------------------- ### Installation with Values File Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Installs the ack-chart using a values file for configuration. ```yaml # AWS services to enable s3: enabled: true aws: region: "us-west-2" rds: enabled: true aws: region: "us-west-2" dynamodb: enabled: true aws: region: "us-west-2" lambda: enabled: true aws: region: "us-west-2" ec2: enabled: true aws: region: "us-west-2" ``` ```bash helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -f production-values.yaml ``` -------------------------------- ### Example: Configuring S3 Controller with Specific Values Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Installs the ack-chart with the S3 controller enabled, specifying replica count and AWS region. ```bash helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --set s3.enabled=true \ --set s3.replicaCount=3 \ --set s3.aws.region=eu-west-1 ``` ```yaml s3: enabled: true replicaCount: 3 aws: region: "eu-west-1" ``` -------------------------------- ### Namespace Installation Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Command to install the ACK chart into a specific namespace, creating it if it doesn't exist. ```bash helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values.yaml ``` -------------------------------- ### Verify Chart Installation Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to list installed Helm charts in the ack-system namespace. ```bash helm list -n ack-system ``` -------------------------------- ### Example S3 Controller IAM Policy Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Illustrative IAM permissions typically required for the S3 controller. ```text - s3:CreateBucket - s3:DeleteBucket - s3:GetBucketVersioning - etc. ``` -------------------------------- ### Minimal Production Setup Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example configuration for a minimal production setup, enabling critical services with explicit region configuration. ```yaml # values-prod.yaml s3: enabled: true aws: region: "us-east-1" rds: enabled: true aws: region: "us-east-1" dynamodb: enabled: true aws: region: "us-east-1" iam: enabled: true aws: region: "us-east-1" ``` -------------------------------- ### Basic Installation with Single Service Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Installs the ack-chart with a single AWS service controller (S3) enabled. ```bash helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --set s3.enabled=true ``` -------------------------------- ### Check Deployed Resources Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to list all pods deployed in the ack-system namespace. ```bash kubectl get pods -n ack-system ``` -------------------------------- ### Custom Post-Install Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example of installing the ACK chart and then applying custom configurations like RBAC and network policies. ```bash # Install chart helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values.yaml # Wait for controllers to be ready kubectl rollout status deployment -n ack-system -l app=ack-controller # Apply custom configurations (RBAC, network policies, etc.) kubectl apply -f custom-rbac.yaml kubectl apply -f custom-network-policies.yaml ``` -------------------------------- ### Deploying Minimal Production Setup Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Command to deploy the minimal production setup using Helm. ```bash helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-prod.yaml ``` -------------------------------- ### Pin to an older version of ack-chart Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example of installing a specific older version of the ack-chart. ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 ``` -------------------------------- ### Enable Additional Service After Installation Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to enable additional services (S3, RDS, EC2) for an existing ack-chart installation. ```bash helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -n ack-system \ --set s3.enabled=true \ --set rds.enabled=true \ --set ec2.enabled=true ``` -------------------------------- ### Troubleshooting Network Errors Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Commands to verify Helm version and OCI registry access for troubleshooting chart installation network errors. ```bash helm version helm pull oci://public.ecr.aws/aws-controllers-k8s/ack-chart --version=46.99.0 ``` -------------------------------- ### Installation with Multiple Services Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Installs the ack-chart with multiple AWS service controllers (S3, RDS, DynamoDB, Lambda) enabled. ```bash helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --set s3.enabled=true \ --set rds.enabled=true \ --set dynamodb.enabled=true \ --set lambda.enabled=true ``` -------------------------------- ### values.yaml Example Entry Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/repository-structure.md An example entry from the values.yaml file, showing how to enable a service. ```yaml s3: enabled: false ``` -------------------------------- ### Helm Version Check Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to check the installed Helm version. ```bash helm version ``` -------------------------------- ### Add ACK Helm Repository Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Adds the ACK Helm repository for Helm versions prior to 3.8 without OCI support. ```bash helm repo add ack-charts oci://public.ecr.aws/aws-controllers-k8s helm repo update ack-charts helm search repo ack-charts/ack-chart ``` -------------------------------- ### Install ACK Chart with Local Development Values Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Workflow example for installing the ACK chart using a local development values file. ```bash # Create local values file cat > values-dev.yaml << EOF s3: enabled: true aws: region: "us-east-1" rds: enabled: true aws: region: "us-east-1" EOF # Install helm install ack-chart oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --namespace=ack-system \ --create-namespace \ -f values-dev.yaml # Verify helm list -n ack-system helm get values ack-chart -n ack-system ``` -------------------------------- ### Example: Create S3 Bucket - Enable S3 controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Helm command to install the ACK chart with the S3 controller enabled. ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --set s3.enabled=true ``` -------------------------------- ### Enable Services in Values Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Commands to check current Helm values and enable specific services like S3. ```bash # Check current values helm get values ack-chart -n ack-system # Enable services helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -n ack-system \ --set s3.enabled=true ``` -------------------------------- ### Verify Enabled Controllers Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to check the deployment status of each enabled controller in the ack-system namespace. ```bash kubectl get deployments -n ack-system ``` -------------------------------- ### Pinning Chart Version in Production Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/dependency-management.md Example of how to install a specific version of the ACK chart in a production environment using Helm. ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 # Specific version ``` -------------------------------- ### Combining multiple values files for installation Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Install the ACK chart by combining multiple values files and setting specific flags. ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f base-values.yaml \ -f region-specific-values.yaml \ --set s3.enabled=true ``` -------------------------------- ### Upgrade to New Chart Version Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to upgrade the ack-chart to a new version. ```bash helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=47.0.0 \ -n ack-system ``` -------------------------------- ### Helm Install - Basic Syntax Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Installs a Helm chart from an OCI registry with specified version, namespace, and optional configurations. ```bash helm install RELEASE_NAME CHART_URL \ --version=VERSION \ --namespace=NAMESPACE \ --create-namespace \ [--set KEY=VALUE] \ [-f VALUES_FILE.yaml] ``` -------------------------------- ### Install the latest version of ack-chart Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Command to install the latest version of the ack-chart from its OCI registry, enabling the S3 controller. ```bash export LATEST_VERSION=$(curl -sL https://api.github.com/repos/aws-controllers-k8s/ack-chart/releases/latest | grep '"tag_name":' | cut -d'"' -f4) helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=$LATEST_VERSION \ --set s3.enabled=true ``` -------------------------------- ### Remove Namespace Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Removes the ack-system namespace after uninstalling the chart. ```bash kubectl delete namespace ack-system ``` -------------------------------- ### Service Controller Enable/Disable Flag Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Example demonstrating how to enable a service controller. ```yaml s3: enabled: true ``` -------------------------------- ### Passing Configuration to Subcharts Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/overview.md Example of a custom values file to pass configuration to subcharts, followed by the installation command. ```yaml # values-production.yaml s3: enabled: true aws: region: "us-west-2" rds: enabled: true aws: region: "us-west-2" ``` ```bash helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-production.yaml ``` -------------------------------- ### Uninstall ack-chart Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Uninstalls the ack-chart Helm release. ```bash helm uninstall ack-chart -n ack-system ``` -------------------------------- ### Install using Helm CLI Flags Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Install the ACK chart by enabling specific services using Helm CLI flags. ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --set s3.enabled=true \ --set rds.enabled=true \ --set dynamodb.enabled=true ``` -------------------------------- ### Create S3 Bucket Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example of a Bucket resource manifest and how to apply it. ```yaml apiVersion: s3.amazonaws.com/v1alpha1 kind: Bucket metadata: name: my-prod-bucket namespace: default spec: bucketName: my-prod-bucket-unique-name region: us-west-2 tags: - key: environment value: production - key: team value: data-team acl: private versioningConfiguration: status: Enabled ``` -------------------------------- ### Upgrade Helm (macOS) Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to upgrade Helm using Homebrew on macOS. ```bash # Using Homebrew (macOS) brew upgrade helm ``` -------------------------------- ### Regional Configuration Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Example values file for consistent regional settings across multiple controllers. ```yaml # values-us-west-2.yaml s3: enabled: true aws: region: "us-west-2" ec2: enabled: true aws: region: "us-west-2" rds: enabled: true aws: region: "us-west-2" ``` -------------------------------- ### Enable a single service controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example of how to enable only the S3 service controller when installing ack-chart. ```yaml s3: enabled: true # All others default to enabled: false ``` -------------------------------- ### Configuration Keys Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/INDEX.md Example of the configuration key pattern used for enabling AWS services within the ACK Chart. ```yaml SERVICE_ALIAS: enabled: boolean # Service-specific configuration ``` -------------------------------- ### Helm Integration Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example of an ACK Bucket resource definition within a Helm chart template. ```yaml apiVersion: s3.amazonaws.com/v1alpha1 kind: Bucket metadata: name: {{ .Release.Name }}-data spec: bucketName: {{ .Release.Name }}-data-{{ .Release.Namespace }} ``` -------------------------------- ### Configuration Structure Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Example demonstrating how to enable and configure specific AWS service controllers (S3, RDS, DynamoDB) by passing service-specific configurations through the parent ACK chart. ```yaml # Enable S3 controller with custom AWS region s3: enabled: true aws: region: "eu-west-1" # Enable RDS controller with custom configuration rds: enabled: true aws: region: "us-east-1" # Additional RDS-specific settings pass through to rds-chart # Enable DynamoDB controller dynamodb: enabled: true ``` -------------------------------- ### Create Namespaces and Deploy Buckets Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example of creating namespaces and deploying the same bucket manifest in different namespaces. ```bash kubectl create namespace team-a kubectl create namespace team-b # Different buckets despite same Kubernetes name kubectl apply -f bucket.yaml -n team-a kubectl apply -f bucket.yaml -n team-b ``` -------------------------------- ### Install the latest version of ack-chart Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/README.md To install the latest version of ack-chart, use the following command: ```bash export LATEST_VERSION=`curl -sL https://api.github.com/repos/aws-controllers-k8s/ack-chart/releases/latest | grep \"tag_name:\" | cut -d'\"' -f4` helm install --create-namespace -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart --version=$LATEST_VERSION ``` -------------------------------- ### Install using a custom values file Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Create a custom values file to override default configurations and then install the chart. ```yaml s3: enabled: true aws: region: "us-west-2" rds: enabled: true aws: region: "us-west-2" lambda: enabled: true aws: region: "us-west-2" ``` ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f custom-values.yaml ``` -------------------------------- ### Per-Cluster Resource Management Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Commands to apply bucket configurations to different Kubernetes clusters. ```bash # Cluster A kubectl apply -f bucket-cluster-a.yaml --kubeconfig=cluster-a.yaml # Cluster B kubectl apply -f bucket-cluster-b.yaml --kubeconfig=cluster-b.yaml ``` -------------------------------- ### GitOps Integration with Kustomization Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example Kustomization file for integrating ACK chart with GitOps tools. ```yaml apiVersion: kustomize.config.k8s.io/v1beta1 kind: Kustomization namespace: ack-system namePrefix: prod- helmCharts: - name: ack-chart repo: oci://public.ecr.aws/aws-controllers-k8s version: 46.99.0 valuesFile: values.yaml ``` -------------------------------- ### Installation with Single Service Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/overview.md Installs the ACK chart with a single service controller (e.g., S3) enabled. ```bash helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --set s3.enabled=true ``` -------------------------------- ### Installation with Multiple Controllers Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/overview.md Installs the ACK chart with multiple service controllers (e.g., S3, RDS, DynamoDB) enabled. ```bash helm install -n ack-system ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --set s3.enabled=true \ --set rds.enabled=true \ --set dynamodb.enabled=true ``` -------------------------------- ### Test New ACK Chart Configuration Before Applying Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Workflow example for generating and reviewing manifests with new configurations before installation. ```bash # Generate manifests to review helm template ack-chart oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --namespace=ack-system \ -f values-new.yaml > manifests.yaml # Review manifests less manifests.yaml # If satisfied, install helm install ack-chart oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --namespace=ack-system \ -f values-new.yaml ``` -------------------------------- ### Modify Configuration of Existing Deployment Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to upgrade the ack-chart and modify its configuration using a values file. ```bash helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -n ack-system \ -f updated-values.yaml ``` -------------------------------- ### Bedrock Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Bedrock controller. ```yaml bedrock: enabled: true ``` -------------------------------- ### Troubleshoot Image Pull Timeout Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Commands to check pod events and image pull status for troubleshooting image pull timeouts. ```bash # Check pod events for details kubectl describe pod POD_NAME -n ack-system # Check image pull status kubectl get pods -n ack-system -o wide ``` -------------------------------- ### Example: S3 Bucket CRD Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md This snippet shows how to check for the S3 Bucket CRD and provides an example of a Kubernetes manifest for creating an S3 Bucket. ```bash kubectl get crd | grep s3.amazonaws.com ``` ```yaml apiVersion: s3.amazonaws.com/v1alpha1 kind: Bucket metadata: name: my-bucket spec: bucketName: my-bucket-prod region: us-west-2 ``` -------------------------------- ### CloudFront Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the CloudFront controller. ```yaml cloudfront: enabled: true ``` -------------------------------- ### Upgrade Existing Installation Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Command to upgrade an existing ACK chart installation with a specific version and custom values. ```bash helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -f custom-values.yaml ``` -------------------------------- ### Create RDS DBInstance Manifest Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example of a DBInstance resource manifest for RDS. ```yaml # rds-instance.yaml apiVersion: rds.amazonaws.com/v1alpha1 kind: DBInstance metadata: name: prod-mysql namespace: default spec: dbInstanceIdentifier: prod-mysql dbInstanceClass: db.t3.micro engine: mysql masterUsername: admin masterUserPassword: name: rds-secret key: password allocatedStorage: 100 storageType: gp3 multiAZ: true backupRetentionPeriod: 7 preferredBackupWindow: "03:00-04:00" tags: - key: environment value: production ``` -------------------------------- ### SageMaker Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the SageMaker controller. ```yaml sagemaker: enabled: true ``` -------------------------------- ### MQ Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the MQ controller. ```yaml mq: enabled: true ``` -------------------------------- ### Kustomize Directory Structure Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example directory structure for managing environment-specific resources with Kustomize. ```yaml kustomize/ ├── base/ │ └── bucket.yaml ├── overlays/ │ ├── dev/ │ │ └── kustomization.yaml │ ├── staging/ │ │ └── kustomization.yaml │ └── prod/ │ └── kustomization.yaml ``` -------------------------------- ### Example: Create S3 Bucket - Wait for controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Command to check the rollout status of the ACK controller deployment. ```bash kubectl rollout status deployment -n ack-system ``` -------------------------------- ### CloudTrail Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the CloudTrail controller. ```yaml cloudtrail: enabled: true ``` -------------------------------- ### Example S3 Controller IAM Policy Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example AWS IAM policy granting necessary permissions for the S3 controller to manage S3 buckets. ```json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:CreateBucket", "s3:DeleteBucket", "s3:GetBucketVersioning", "s3:GetBucketLocation", "s3:ListBucket", "s3:PutBucketVersioning", "s3:GetObjectTagging", "s3:PutObjectTagging" ], "Resource": "*" } ] } ``` -------------------------------- ### CloudWatch Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the CloudWatch controller. ```yaml cloudwatch: enabled: true ``` -------------------------------- ### Dry Run Installation Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Performs a Helm installation without actually deploying resources, useful for validating configuration. ```bash helm install ack-chart CHART_URL \ --version=46.99.0 \ --namespace=ack-system \ --dry-run \ --debug ``` -------------------------------- ### IAM Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the IAM controller. ```yaml iam: enabled: true ``` -------------------------------- ### CodeArtifact Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the CodeArtifact controller. ```yaml codeartifact: enabled: true ``` -------------------------------- ### Bedrock Agent Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Bedrock Agent controller. ```yaml bedrockagent: enabled: true ``` -------------------------------- ### Organizations Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Organizations controller. ```yaml organizations: enabled: true ``` -------------------------------- ### Layered Configuration Deployment Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example command demonstrating layered configuration using multiple values files for inheritance. ```bash # Base configuration for all environments helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-base.yaml \ -f values-prod.yaml \ -f values-specific-cluster.yaml ``` -------------------------------- ### EventBridge Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the EventBridge controller. ```yaml eventbridge: enabled: true ``` -------------------------------- ### Recycle Bin Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Recycle Bin controller. ```yaml recyclebin: enabled: true ``` -------------------------------- ### Network Firewall Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Network Firewall controller. ```yaml networkfirewall: enabled: true ``` -------------------------------- ### OpenSearch Service Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the OpenSearch Service controller. ```yaml opensearchservice: enabled: true ``` -------------------------------- ### Chart.yaml and values.yaml Synchronization Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/repository-structure.md Illustrates the required synchronization between Chart.yaml and values.yaml for dependencies and conditions. ```yaml # Chart.yaml - name: s3-chart alias: s3 condition: s3.enabled # values.yaml must have: s3: enabled: false ``` -------------------------------- ### Enable Kafka Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the Kafka controller in the Helm chart values. ```yaml kafka: enabled: true ``` -------------------------------- ### Helm Template and Deploy Workflow Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Steps to generate manifests, review them, test in a non-production cluster, and apply to production. ```bash helm template ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -f values-new.yaml > manifests.yaml less manifests.yaml helm install test-ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -n test-ack \ -f values-new.yaml helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ -n prod-ack \ -f values-new.yaml ``` -------------------------------- ### CloudWatch Logs Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the CloudWatch Logs controller. ```yaml cloudwatchlogs: enabled: true ``` -------------------------------- ### API Gateway Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the API Gateway controller. ```yaml apigateway: enabled: true ``` -------------------------------- ### Deploying Multi-Region Setup Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Commands to deploy the same services to different regions using separate Helm releases and kubeconfigs. ```bash # US cluster helm install -n ack-system ack-chart-us \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-us-west-2.yaml \ --kubeconfig=$US_KUBECONFIG # EU cluster helm install -n ack-system ack-chart-eu \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-eu-west-1.yaml \ --kubeconfig=$EU_KUBECONFIG ``` -------------------------------- ### EventBridge Pipes Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the EventBridge Pipes controller. ```yaml pipes: enabled: true ``` -------------------------------- ### Prometheus Service Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Prometheus Service controller. ```yaml prometheusservice: enabled: true ``` -------------------------------- ### Step Functions Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Step Functions controller. ```yaml sfn: enabled: true ``` -------------------------------- ### Enable Keyspaces Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the Keyspaces controller in the Helm chart values. ```yaml keyspaces: enabled: true ``` -------------------------------- ### ECR Public Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the ECR Public controller. ```yaml ecrpublic: enabled: true ``` -------------------------------- ### Strategic Merge Patch Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md YAML content for a strategic merge patch to update bucket tags. ```yaml spec: tags: - key: new-tag value: new-value ``` -------------------------------- ### Single Service Deployment Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/configuration.md Example values file for deploying only one service controller (S3). ```yaml # values-single-s3.yaml s3: enabled: true ``` ```bash helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ -f values-single-s3.yaml ``` -------------------------------- ### Helm Get Values Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Retrieves the current configuration values for an installed Helm release. ```bash helm get values RELEASE_NAME --namespace=NAMESPACE ``` -------------------------------- ### WAFv2 (Web Application Firewall V2) Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the WAFv2 controller. ```yaml wafv2: enabled: true ``` -------------------------------- ### Enable DocumentDB Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the DocumentDB controller in the Helm chart values. ```yaml documentdb: enabled: true ``` -------------------------------- ### Test Resource Creation Apply and Describe Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Commands to apply a test resource and then describe it to monitor its status. ```bash kubectl apply -f test.yaml kubectl describe bucket test-bucket ``` -------------------------------- ### Route 53 Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Route 53 controller. ```yaml route53: enabled: true ``` -------------------------------- ### Enable SQS Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the SQS controller in the Helm chart values. ```yaml sqs: enabled: true ``` -------------------------------- ### Deletion Protection Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md YAML snippet showing how to enable deletion protection for a resource spec. ```yaml spec: deletionProtection: true ``` -------------------------------- ### Enable MemoryDB Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the MemoryDB controller in the Helm chart values. ```yaml memorydb: enabled: true ``` -------------------------------- ### Enable DynamoDB Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the DynamoDB controller in the Helm chart values. ```yaml dynamodb: enabled: true ``` -------------------------------- ### Check CRD Registration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Command to list all Custom Resource Definitions (CRDs) provided by ACK controllers. ```bash # List all CRDs provided by ACK controllers kubectl get crd | grep "amazonaws.com" ``` -------------------------------- ### GitOps Integration Values File Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example values file for GitOps integration, enabling S3 and RDS controllers. ```yaml s3: enabled: true aws: region: "us-east-1" rds: enabled: true aws: region: "us-east-1" ``` -------------------------------- ### API Gateway V2 Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the API Gateway V2 controller. ```yaml apigatewayv2: enabled: true ``` -------------------------------- ### Enable EFS Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the EFS controller in the Helm chart values. ```yaml efs: enabled: true ``` -------------------------------- ### KMS (Key Management Service) Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the KMS controller. ```yaml kms: enabled: true ``` -------------------------------- ### Enable Lambda Controller Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example of enabling the Lambda controller in the Helm chart values. ```yaml lambda: enabled: true ``` -------------------------------- ### Systems Manager (SSM) Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Systems Manager (SSM) controller. ```yaml ssm: enabled: true ``` -------------------------------- ### Application Auto Scaling Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Application Auto Scaling controller. ```yaml applicationautoscaling: enabled: true ``` -------------------------------- ### ArgoCD Application Manifest Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Example ArgoCD Application manifest for syncing Kubernetes manifests defining AWS resources. ```yaml apiVersion: argoproj.io/v1alpha1 kind: Application metadata: name: my-app-infrastructure spec: source: repoURL: https://github.com/my-org/infra path: aws-resources/ destination: server: https://kubernetes.default.svc namespace: default ``` -------------------------------- ### Helm Dependency Condition Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/dependency-management.md Illustrates how a condition in Chart.yaml controls the deployment of a subchart, with corresponding values in values.yaml. ```yaml # In Chart.yaml - name: s3-chart alias: s3 version: 1.6.0 repository: oci://public.ecr.aws/aws-controllers-k8s condition: s3.enabled # This is the condition # In values.yaml s3: enabled: false # When false, s3-chart is NOT deployed ``` ```yaml s3: enabled: true # s3-chart is deployed ``` ```yaml # If s3 is not in values.yaml, uses s3-chart's defaults ``` -------------------------------- ### ELBv2 (Elastic Load Balancing V2) Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the ELBv2 controller. ```yaml elbv2: enabled: true ``` -------------------------------- ### Debug CRD Registration Issues Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/installation-guide.md Commands to debug issues where CRDs are not registered, including checking pod status, controller logs, and namespace events. ```bash # Check controller pod status kubectl get pods -n ack-system # View logs of a controller kubectl logs -n ack-system deployment/CONTROLLER_NAME # Check events in the namespace kubectl get events -n ack-system --sort-by='.lastTimestamp' ``` -------------------------------- ### OCI Registry Repository Structure Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/dependency-management.md Illustrates the naming convention for ACK service controller charts within the OCI registry, showing the full repository URL with chart name and version. ```text CHART_NAME: {service-name}-chart ALIAS: {service-name} REGISTRY: oci://public.ecr.aws/aws-controllers-k8s/{chart-name}:{version} Examples: - S3 Chart: oci://public.ecr.aws/aws-controllers-k8s/s3-chart:1.6.0 - RDS Chart: oci://public.ecr.aws/aws-controllers-k8s/rds-chart:1.8.0 - Lambda Chart: oci://public.ecr.aws/aws-controllers-k8s/lambda-chart:1.13.0 ``` -------------------------------- ### Values File Syntax Example Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Demonstrates the YAML format for Helm values files, including nested objects, lists, and boolean/string values. ```yaml # Service enable/disable s3: enabled: true aws: region: "us-west-2" rds: enabled: true aws: region: "us-west-2" # Lists someArray: - item1 - item2 # Nested objects config: nested: key: value number: 42 bool: true ``` -------------------------------- ### Multi-Region Deployment - EU West 1 Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example values file for deploying services to the eu-west-1 region. ```yaml # values-eu-west-1.yaml s3: enabled: true aws: region: "eu-west-1" rds: enabled: true aws: region: "eu-west-1" ``` -------------------------------- ### Enable multiple service controllers using command-line flags Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example of enabling S3, RDS, and DynamoDB controllers using Helm's --set flag. ```bash helm install ack-chart ... \ --set s3.enabled=true \ --set rds.enabled=true \ --set dynamodb.enabled=true ``` -------------------------------- ### Multi-Region Deployment - US West 2 Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example values file for deploying services to the us-west-2 region. ```yaml # values-us-west-2.yaml s3: enabled: true aws: region: "us-west-2" rds: enabled: true aws: region: "us-west-2" ``` -------------------------------- ### Progressive Enablement - Adding DynamoDB Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Upgrading ack-chart to enable S3, RDS, and DynamoDB services. ```bash # Later: Add DynamoDB helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --set s3.enabled=true \ --set rds.enabled=true \ --set dynamodb.enabled=true ``` -------------------------------- ### Lock File Structure Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/dependency-management.md An example of the `Chart.lock` file structure, showing the list of dependencies with their exact versions, a digest, and a generation timestamp. ```yaml dependencies: - name: acm-chart repository: oci://public.ecr.aws/aws-controllers-k8s version: 1.4.0 - name: acmpca-chart repository: oci://public.ecr.aws/aws-controllers-k8s version: 1.3.0 # ... 57 more dependencies digest: sha256:8694773a1c9a2301ef4713138dbef8310431b4760606fd0864c448c55475fc2b generated: "2026-05-26T21:44:25.198601891Z" ``` -------------------------------- ### Progressive Enablement - Initial Deployment Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Initial deployment of ack-chart with only the S3 service enabled. ```bash # Initial deployment - only S3 helm install ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --set s3.enabled=true ``` -------------------------------- ### Get Controller Events Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Command to retrieve events emitted by ACK controllers. ```bash kubectl get events -n ack-system ``` -------------------------------- ### Compare Current vs New ACK Chart Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Workflow example for comparing rendered manifests of current and new configurations. ```bash # Get current rendered manifests helm get manifest ack-chart -n ack-system > current-manifests.yaml # Generate new manifests helm template ack-chart oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --version=46.99.0 \ --namespace=ack-system \ -f values-new.yaml > new-manifests.yaml ``` -------------------------------- ### Detailed Bucket Status Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Command to get detailed status and conditions for a specific bucket. ```bash kubectl describe bucket my-prod-bucket ``` -------------------------------- ### Monitor Bucket Creation Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Commands to monitor the creation status of a Bucket resource. ```bash kubectl get bucket kubectl describe bucket my-prod-bucket ``` -------------------------------- ### Monitor Resource Status Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Commands to get the status of created buckets and DB instances. ```bash kubectl get buckets kubectl get dbinstances ``` -------------------------------- ### Helm Get Manifest Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Displays the rendered Kubernetes manifests for a Helm release. ```bash helm get manifest RELEASE_NAME --namespace=NAMESPACE ``` -------------------------------- ### Enable multiple service controllers using a values file Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example of enabling S3, RDS, and DynamoDB controllers by defining them in a values file. ```yaml s3: enabled: true rds: enabled: true dynamodb: enabled: true ``` -------------------------------- ### Set Nested Values Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Sets nested configuration values for a Helm release during installation. ```bash helm install ack-chart CHART_URL \ --set s3.enabled=true \ --set s3.aws.region=us-west-2 \ --set s3.replicaCount=3 ``` -------------------------------- ### Set Multiple Values Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Sets multiple configuration values for a Helm release during installation. ```bash helm install ack-chart CHART_URL \ --set s3.enabled=true \ --set rds.enabled=true \ --set dynamodb.enabled=true ``` -------------------------------- ### Apply RDS DBInstance Manifest Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/kubernetes-integration.md Command to apply the rds-instance.yaml manifest. ```bash kubectl apply -f rds-instance.yaml ``` -------------------------------- ### Set Single Value Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Sets a single configuration value for a Helm release during installation. ```bash helm install ack-chart CHART_URL \ --set s3.enabled=true ``` -------------------------------- ### Pass configuration to individual service controllers Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Example of configuring the S3 controller with a specific region and replica count. ```yaml s3: enabled: true aws: region: "us-west-2" replicaCount: 3 ``` -------------------------------- ### EMR Containers Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the EMR Containers controller. ```yaml emrcontainers: enabled: true ``` -------------------------------- ### Compare Manifests Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/helm-operations.md Compares the current and new Kubernetes manifests using diff. ```bash diff -u current-manifests.yaml new-manifests.yaml | less ``` -------------------------------- ### Secrets Manager Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Secrets Manager controller. ```yaml secretsmanager: enabled: true ``` -------------------------------- ### Bedrock Agent Core Control Controller Configuration Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/service-controllers.md Example configuration to enable the Bedrock Agent Core Control controller. ```yaml bedrockagentcorecontrol: enabled: true ``` -------------------------------- ### Progressive Enablement - Adding RDS Source: https://github.com/aws-controllers-k8s/ack-chart/blob/main/_autodocs/faq-and-patterns.md Upgrading ack-chart to enable both S3 and RDS services. ```bash # Later: Add RDS helm upgrade ack-chart \ oci://public.ecr.aws/aws-controllers-k8s/ack-chart \ --set s3.enabled=true \ --set rds.enabled=true ```