[ECK 3.3] - Elastic Package Registry release documentation

deploy-manage/deploy/cloud-on-k8s/managing-deployments-using-helm-chart.md

@@ -82,6 +82,24 @@ helm install eck-stack-with-apm-server elastic/eck-stack \
     --values https://raw.githubusercontent.com/elastic/cloud-on-k8s/{{version.eck | M.M}}/deploy/eck-stack/examples/apm-server/basic.yaml -n elastic-stack
 ```
 
+## Package Registry along with {{es}} and {{kib}} [k8s-install-package-registry-elasticsearch-kibana-helm]
+
+```{applies_to}
+  eck: ga 3.3
+```
+
+The following section allows installing a PackageRegistry resource along with {{es}}, {{kib}} and {{fleet-server}}.
+
+```sh subs=true
+# Install an eck-managed {{es}}, {{kib}} and {{fleet-server}} and connect to Package Registry using custom values.
+helm install eck-stack-with-package-registry elastic/eck-stack \
+    --values https://raw.githubusercontent.com/elastic/cloud-on-k8s/{{version.eck | M.M}}/deploy/eck-stack/examples/package-registry/basic-eck.yaml -n elastic-stack
+```
+
+The `eck-package-registry` chart creates a `PackageRegistry` resource that connects your {{kib}} instance to the Package Registry. {{eck}} automatically handles the creation of the Package Registry and the connection to {{kib}} and {{fleet-server}}.
+
+For more information about configuring Package Registry, refer to the [Package Registry documentation](/deploy-manage/deploy/cloud-on-k8s/package-registry.md).
+
 ## Enterprise Search server along with {{es}} and {{kib}} [k8s-install-enterprise-search-elasticsearch-kibana-helm]
 
 Enterprise Search is not available in {{stack}} versions 9.0 and later. For an example deployment of {{es}} version 8.x, {{kib}} 8.x, and an 8.x Enterprise Search server using the Helm chart, refer to the [previous ECK documentation](https://www.elastic.co/guide/en/cloud-on-k8s/2.16/k8s-stack-helm-chart.html).
@@ -192,4 +210,5 @@ helm show values elastic/eck-beats
 helm show values elastic/eck-apm-server
 helm show values elastic/eck-fleet-server
 helm show values elastic/eck-logstash
+helm show values elastic/eck-package-registry
 ```

deploy-manage/deploy/cloud-on-k8s/orchestrate-other-elastic-applications.md

@@ -13,6 +13,7 @@ The following guides provide specific instructions for deploying and configuring
 * [Elastic Maps Server](elastic-maps-server.md)
 * [Beats](beats.md)
 * [{{ls}}](logstash.md)
+* [{{package-registry}}](package-registry.md)
 
 ::::{note}
 Enterprise Search is not available in {{stack}} versions 9.0 and later. To deploy or manage Enterprise Search in earlier versions, refer to the [previous ECK documentation](https://www.elastic.co/guide/en/cloud-on-k8s/2.16/k8s-enterprise-search.html).

deploy-manage/deploy/cloud-on-k8s/package-registry.md

@@ -0,0 +1,79 @@
+---
+navigation_title: Elastic Package Registry
+mapped_pages:
+  - https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-package-registry.html
+applies_to:
+  deployment:
+    eck: ga 3.3
+products:
+  - id: cloud-kubernetes
+---
+
+# Deploy {{package-registry}} on {{eck}} [k8s-package-registry]
+
+```{applies_to}
+deployment:
+  eck: ga 3.3
+```
+
+Starting with ECK 3.3, you can deploy and manage the {{package-registry}} (EPR) as a {{k8s}} resource using ECK. The {{package-registry}} is a service that stores Elastic package definitions in a central location, making it easier to manage integrations in air-gapped environments or when you need to use a private registry.
+
+## Overview
+
+The {{package-registry}} provides a centralized repository for {{product.integrations}} packages. When deployed with ECK, it runs as a containerized service in your {{k8s}} cluster and can be used by {{kib}} instances to download and manage integration packages for {{fleet}}.
+
+## Deploy the Package Registry
+
+To deploy the {{package-registry}}, create a `PackageRegistry` resource:
+
+```yaml
+apiVersion: packageregistry.k8s.elastic.co/v1alpha1
+kind: PackageRegistry
+metadata:
+  name: package-registry-sample
+  namespace: default
+spec:
+  version: {{version.stack}}
+  count: 1
+```
+
+The operator automatically creates the necessary {{k8s}} resources, including:
+
+* A Deployment for the {{package-registry}} pods
+* A Service to expose the {{package-registry}} within your cluster
+* TLS certificates for secure communication
+
+## Connect {{kib}} to the Package Registry
+
+After deploying the {{package-registry}}, configure your {{kib}} instance to use it by setting the `spec.packageRegistryRef` field:
+
+```yaml
+apiVersion: kibana.k8s.elastic.co/v1
+kind: Kibana
+metadata:
+  name: kibana-sample
+  namespace: default
+spec:
+  version: {{version.stack}}
+  count: 1
+  packageRegistryRef:
+    name: package-registry-sample
+```
+
+Check the [recipes directory](https://github.com/elastic/cloud-on-k8s/tree/{{version.eck | M.M}}/config/recipes/packageregistry) for Package Registry in the ECK source repository for additional configuration examples.
+
+## Troubleshooting
+
+### Packages are not available
+
+The {{package-registry}} distribution images contain a snapshot of packages. Ensure you're using the correct image version that is equal to or greater than your {{stack}} version. For the latest packages, use the `production` or `lite` distribution tags:
+
+* `docker.elastic.co/package-registry/distribution:production` - All packages from the production registry
+* `docker.elastic.co/package-registry/distribution:lite` - Subset of commonly used packages
+
+## See also
+
+* [Configure Fleet in ECK](configuration-fleet.md)
+* [Running ECK in air-gapped environments](air-gapped-install.md)
+* [Set the proxy URL of the Elastic Package Registry](/reference/fleet/epr-proxy-setting.md)
+* [Host your own Package Registry](/reference/fleet/air-gapped.md#air-gapped-diy-epr)

deploy-manage/toc.yml

@@ -270,6 +270,7 @@ toc:
                   - file: deploy/cloud-on-k8s/configuration-examples-logstash.md
                   - file: deploy/cloud-on-k8s/update-strategy-logstash.md
                   - file: deploy/cloud-on-k8s/advanced-configuration-logstash.md
+              - file: deploy/cloud-on-k8s/package-registry.md
           - file: deploy/cloud-on-k8s/create-custom-images.md
           - file: deploy/cloud-on-k8s/tools-apis.md
       - file: deploy/self-managed.md