From a54cbc91823a82d0656ce68a60661d2831293f78 Mon Sep 17 00:00:00 2001 From: antongisli Date: Wed, 13 Sep 2023 19:59:49 +0200 Subject: [PATCH] docs: update registries-and-packs.md * Update registries-and-packs.md WIP - as part of an attempt to consolidate terminology around packs, layers, and cluster profiles, this is a quick test PR based on https://docs.google.com/presentation/d/1w5PSUgyNH59Tz0AIPrBZ7UwxO9j5M7dZKdJhEIBHdr0/edit#slide=id.p31 * Update registries-and-packs.md * Apply suggestions from code review Co-authored-by: Rita Watson <117382432+ritawatson@users.noreply.github.com> --------- Co-authored-by: Rita Watson <117382432+ritawatson@users.noreply.github.com> Co-authored-by: Karl Cardenas (cherry picked from commit 0f15f051d62c69c681eeaee8abd70a575957e75d) --- .../registries-and-packs/registries-and-packs.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/docs-content/registries-and-packs/registries-and-packs.md b/docs/docs-content/registries-and-packs/registries-and-packs.md index 60b377d9ce..3a9c7802db 100644 --- a/docs/docs-content/registries-and-packs/registries-and-packs.md +++ b/docs/docs-content/registries-and-packs/registries-and-packs.md @@ -13,19 +13,19 @@ sidebar_custom_props: # Packs -A **Cluster Profile** is made up of preconfigured layers, each of which is called a pack. In other words, **Packs** are the building block of a cluster profile to create layers such as operating systems, Kubernetes, network, storage, and add-ons. Packs can be broadly categorized into two types: +A **Cluster Profile** is made up of layers, each of which is created using a pack. Packs can be broadly categorized into two types: -- **Core** packs - These packs model the core layers to provision a Kubernetes cluster. These packs include the operating system, Kubernetes, the container network interface (CNI), and the container storage interface (CSI) specifications. Spectro Cloud builds and maintains these core packs for updates. +- **Infrastructure** packs - These packs are used to create the core infrastructure layers required to provision a Kubernetes cluster. These packs include the operating system, Kubernetes, the container network interface (CNI), and the container storage interface (CSI) specifications. Spectro Cloud builds and maintains these infrastructure packs for updates. -- **Add-On** packs - These packs model the infrastructure integrations and applications that exist on top of the core packs. Examples of applications are system, authentication, security, monitoring, logging, ingress, load balancer, service mesh, or helm charts. +- **Add-on** packs - These packs are used to form the integrations and application layers that exist on top of the infrastructure layers. Examples of applications are system, authentication, security, monitoring, logging, ingress, load balancer, service mesh, or helm charts. -Both the core and add-on packs described above are configurable, and you can define new add-on custom packs from scratch as well. The use case for defining new add-on packs is to have desired consistent governance across your profile deployments. +Both the infrastructure and add-on packs described above are configurable, and you can define new add-on custom packs from scratch as well. The use case for defining new add-on packs is to drive consistency across your profile deployments. ## Pack Structure -Palette provides a rich collection of out-of-the-box packs for various integrations and also offers extensibility through custom-built packs. To configure an existing pack (core or add-on) or to define a new add-on custom pack from scratch, it is essential to understand the pack structure. +Palette provides a rich collection of out-of-the-box packs for various integrations and also offers extensibility through custom-built packs. To configure an existing infrastructure or add-on pack or to define a new add-on custom pack, it is essential to understand the pack structure. Each pack is a collection of files such as manifests, helm charts, Ansible roles, configuration files, and more. Ansible roles, if provided, are used to customize cluster VM images, whereas Kubernetes manifests and Helm charts are applied to the Kubernetes clusters after deployment. The following is a typical pack structure: