From 477e50155889b4bafeca23f2db80691c746a3846 Mon Sep 17 00:00:00 2001 From: Shubha Narayanan Date: Tue, 8 Apr 2025 16:56:15 +0530 Subject: [PATCH 1/6] Openshift editions and K8s overview --- _topic_maps/_topic_map.yml | 12 +++++--- welcome/kubernetes-overview.adoc | 35 ++++++++++++++++++++++++ welcome/openshift-editions.adoc | 47 ++++++++++++++++++++++++++++++++ 3 files changed, 90 insertions(+), 4 deletions(-) create mode 100644 welcome/kubernetes-overview.adoc create mode 100644 welcome/openshift-editions.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 6cc2909ead3a..69ce483d6e4e 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -23,7 +23,7 @@ # topic groups and topics on the main page. --- -Name: About +Name: Overview Dir: welcome Distros: openshift-enterprise,openshift-webscale,openshift-origin,openshift-online,openshift-dpu,openshift-telco Topics: @@ -31,12 +31,16 @@ Topics: File: index - Name: Learn more about OpenShift Container Platform File: learn_more_about_openshift -- Name: Providing documentation feedback - File: providing-feedback-on-red-hat-documentation +- Name: OpenShift editions + File: openshift-editions +- Name: Kubernetes overview + File: kubernetes-overview Distros: openshift-enterprise -- Name: About OpenShift Kubernetes Engine +- Name: OpenShift Kubernetes Engine overview File: oke_about Distros: openshift-enterprise +- Name: Providing documentation feedback + File: providing-feedback-on-red-hat-documentation - Name: Legal notice File: legal-notice Distros: openshift-enterprise,openshift-online diff --git a/welcome/kubernetes-overview.adoc b/welcome/kubernetes-overview.adoc new file mode 100644 index 000000000000..2b765cbcf108 --- /dev/null +++ b/welcome/kubernetes-overview.adoc @@ -0,0 +1,35 @@ +:_mod-docs-content-type: ASSEMBLY +[id="kubernetes-overview"] += Kubernetes overview +include::_attributes/common-attributes.adoc[] +:context: kubernetes-overview + +toc::[] + +Kubernetes is an open source container orchestration tool developed by Google. You can run and manage container-based workloads by using Kubernetes. The most common Kubernetes use case is to deploy an array of interconnected microservices, building an application in a cloud native way. You can create Kubernetes clusters that can span hosts across on-premise, public, private, or hybrid clouds. + +Traditionally, applications were deployed on top of a single operating system. With virtualization, you can split the physical host into several virtual hosts. Working on virtual instances on shared resources is not optimal for efficiency and scalability. Because a virtual machine (VM) consumes as many resources as a physical machine, providing resources to a VM such as CPU, RAM, and storage can be expensive. Also, you might see your application degrading in performance due to virtual instance usage on shared resources. + +.Evolution of container technologies for classical deployments +image::247-OpenShift-Kubernetes-Overview.png[] + +To solve this problem, you can use containerization technologies that segregate applications in a containerized environment. Similar to a VM, a container has its own filesystem, vCPU, memory, process space, dependencies, and more. Containers are decoupled from the underlying infrastructure, and are portable across clouds and OS distributions. Containers are inherently much lighter than a fully-featured OS, and are lightweight isolated processes that run on the operating system kernel. VMs are slower to boot, and are an abstraction of physical hardware. VMs run on a single machine with the help of a hypervisor. + +You can perform the following actions by using Kubernetes: + +* Sharing resources +* Orchestrating containers across multiple hosts +* Installing new hardware configurations +* Running health checks and self-healing applications +* Scaling containerized applications + +include::modules/kubernetes-components.adoc[leveloffset=+1] + +include::modules/kubernetes-resources.adoc[leveloffset=+1] + +.Architecture of Kubernetes +image::247_OpenShift_Kubernetes_Overview-2.png[] + +A cluster is a single computational unit consisting of multiple nodes in a cloud environment. A Kubernetes cluster includes a control plane and worker nodes. You can run Kubernetes containers across various machines and environments. The control plane node controls and maintains the state of a cluster. You can run the Kubernetes application by using worker nodes. You can use the Kubernetes namespace to differentiate cluster resources in a cluster. Namespace scoping is applicable for resource objects, such as deployment, service, and pods. You cannot use namespace for cluster-wide resource objects such as storage class, nodes, and persistent volumes. + +include::modules/kubernetes-conceptual-guidelines.adoc[leveloffset=+1] \ No newline at end of file diff --git a/welcome/openshift-editions.adoc b/welcome/openshift-editions.adoc new file mode 100644 index 000000000000..6b449980389a --- /dev/null +++ b/welcome/openshift-editions.adoc @@ -0,0 +1,47 @@ +:_mod-docs-content-type: ASSEMBLY +[id="openshift-editions] += Red Hat OpenShift editions +include::_attributes/common-attributes.adoc[] +:context: openshift-editions + +toc::[] + +Red Hat OpenShift is offered in several editions to support a wide range of deployment models and operational preferences. Each edition delivers a consistent Kubernetes platform with integrated tools, security features, and developer experiences. OpenShift is available in cloud services and self-managed editions. + +[id="cloud-services-editions_{context}] +== Cloud services editions + +Red Hat OpenShift offers various cloud service editions to cater to different organizational needs. These editions provide fully managed application platforms from major cloud providers. + +{{product-rosa}} (ROSA):: A fully managed application platform that helps organizations build, deploy, and scale applications in a native AWS environment. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/aws[{{product-rosa}}]. + +{{azure-first}} Red Hat OpenShift:: A fully managed application platform that helps organizations build, deploy, and scale applications on Azure. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/azure[{{azure-first}} Red Hat OpenShift]. + +{{product-dedicated}}:: A managed Red Hat OpenShift offering available on Google Cloud Platform (GCP). +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/dedicated[{{product-dedicated}}]. + +Red Hat OpenShift on {{ibm-cloud-title}}:: A managed OpenShift cloud service that reduces operational complexity and helps developers build and scale applications on {{ibm-cloud-title}}. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/ibm[Red Hat OpenShift on {{ibm-cloud-title}}]. + +[id="self-managed-editions_{context}] +== Self-managed editions + +Red Hat OpenShift offers self-managed editions for organizations that prefer to deploy, configure, and manage OpenShift on their own infrastructure. These editions provide flexibility and control over the platform while leveraging the capabilities of OpenShift. + +Red Hat {product-title} (OCP):: +Provides complete set of operations and developer services and tools for building and scaling containerized applications. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/container-platform[Red Hat {product-title}]. + +Red Hat {{opp}}:: +Builds on the capabilities of {product-title}. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/platform-plus[Red Hat {{opp}}]. + +Red Hat {{oke}}:: +Delivers the foundational, security-focused capabilities of enterprise Kubernetes on {{op-system-first}} to run containers in hybrid cloud environments. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/kubernetes-engine[Red Hat {{oke}}]. + +{{ove-first}}:: +Provides the virtualization capabilities of Red Hat OpenShift in a streamlined, cost-effective solution to deploy, manage, and scale VMs exclusively. +For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/virtualization-engine[{{ove-first}}]. \ No newline at end of file From 74744795e8d535fc7c9015ee26412f1390a3416d Mon Sep 17 00:00:00 2001 From: Shubha Narayanan Date: Mon, 14 Apr 2025 12:09:12 +0530 Subject: [PATCH 2/6] Editions and k8s overview --- welcome/openshift-editions.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/welcome/openshift-editions.adoc b/welcome/openshift-editions.adoc index 6b449980389a..723f0fd22e7b 100644 --- a/welcome/openshift-editions.adoc +++ b/welcome/openshift-editions.adoc @@ -8,7 +8,7 @@ toc::[] Red Hat OpenShift is offered in several editions to support a wide range of deployment models and operational preferences. Each edition delivers a consistent Kubernetes platform with integrated tools, security features, and developer experiences. OpenShift is available in cloud services and self-managed editions. -[id="cloud-services-editions_{context}] +[id="cloud-services-editions_{context}"] == Cloud services editions Red Hat OpenShift offers various cloud service editions to cater to different organizational needs. These editions provide fully managed application platforms from major cloud providers. @@ -25,7 +25,7 @@ For more information, see link:https://www.redhat.com/en/technologies/cloud-comp Red Hat OpenShift on {{ibm-cloud-title}}:: A managed OpenShift cloud service that reduces operational complexity and helps developers build and scale applications on {{ibm-cloud-title}}. For more information, see link:https://www.redhat.com/en/technologies/cloud-computing/openshift/ibm[Red Hat OpenShift on {{ibm-cloud-title}}]. -[id="self-managed-editions_{context}] +[id="self-managed-editions_{context}"] == Self-managed editions Red Hat OpenShift offers self-managed editions for organizations that prefer to deploy, configure, and manage OpenShift on their own infrastructure. These editions provide flexibility and control over the platform while leveraging the capabilities of OpenShift. From 647bce6910dfaaa88f3264683c565c32f19981cf Mon Sep 17 00:00:00 2001 From: Shubha Narayanan Date: Mon, 14 Apr 2025 12:21:45 +0530 Subject: [PATCH 3/6] Editions and k8s overview --- _topic_maps/_topic_map.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 69ce483d6e4e..ccae92152a5b 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -33,8 +33,6 @@ Topics: File: learn_more_about_openshift - Name: OpenShift editions File: openshift-editions -- Name: Kubernetes overview - File: kubernetes-overview Distros: openshift-enterprise - Name: OpenShift Kubernetes Engine overview File: oke_about From 39bb58f4d39bc76e17a127b9be5435ce9b812093 Mon Sep 17 00:00:00 2001 From: Shubha Narayanan Date: Mon, 14 Apr 2025 12:40:21 +0530 Subject: [PATCH 4/6] Editions and k8s overview --- welcome/openshift-editions.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/welcome/openshift-editions.adoc b/welcome/openshift-editions.adoc index 723f0fd22e7b..501f76af6afc 100644 --- a/welcome/openshift-editions.adoc +++ b/welcome/openshift-editions.adoc @@ -1,5 +1,5 @@ :_mod-docs-content-type: ASSEMBLY -[id="openshift-editions] +[id="openshift-editions"] = Red Hat OpenShift editions include::_attributes/common-attributes.adoc[] :context: openshift-editions From b057ffce5a697bc0e934d677470a3f51c52ecb28 Mon Sep 17 00:00:00 2001 From: Shubha Narayanan Date: Mon, 14 Apr 2025 12:57:45 +0530 Subject: [PATCH 5/6] Editions and k8s overview --- _topic_maps/_topic_map.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index ccae92152a5b..69ce483d6e4e 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -33,6 +33,8 @@ Topics: File: learn_more_about_openshift - Name: OpenShift editions File: openshift-editions +- Name: Kubernetes overview + File: kubernetes-overview Distros: openshift-enterprise - Name: OpenShift Kubernetes Engine overview File: oke_about From 0a76b214566f43889fe6b9673bd2f57dbbc2b847 Mon Sep 17 00:00:00 2001 From: Shubha Narayanan Date: Tue, 15 Apr 2025 17:54:08 +0530 Subject: [PATCH 6/6] Removed elastic search --- _topic_maps/_topic_map.yml | 4 ++-- welcome/oke_about.adoc | 3 +-- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 69ce483d6e4e..f6cfa5b0b8c3 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -31,10 +31,10 @@ Topics: File: index - Name: Learn more about OpenShift Container Platform File: learn_more_about_openshift -- Name: OpenShift editions - File: openshift-editions - Name: Kubernetes overview File: kubernetes-overview +- Name: OpenShift editions + File: openshift-editions Distros: openshift-enterprise - Name: OpenShift Kubernetes Engine overview File: oke_about diff --git a/welcome/oke_about.adoc b/welcome/oke_about.adoc index 6b81b8993a8f..aea8deec83ec 100644 --- a/welcome/oke_about.adoc +++ b/welcome/oke_about.adoc @@ -194,7 +194,7 @@ the kubevirt.io open source project. === Advanced cluster management {oke} is compatible with your additional purchase of {rh-rhacm-first} for Kubernetes. An {oke} subscription does not offer a cluster-wide log aggregation -solution or support Elasticsearch, Fluentd, or Kibana-based logging solutions. +solution or support Fluentd, or Kibana-based logging solutions. {SMProductName} capabilities derived from the open-source istio.io and kiali.io projects that offer OpenTracing observability for containerized services on {product-title} are not supported in {oke}. @@ -293,7 +293,6 @@ s| Feature s| {oke} s| {product-title} s| Operator name | User Workload Monitoring | Not Included | Included | N/A | Cost Management SaaS Service | Included | Included | Cost Management Metrics Operator | Platform Logging | Not Included | Included | Red Hat OpenShift Logging Operator -| OpenShift Elasticsearch Operator provided by Red Hat | Not Included | Cannot be run standalone | N/A | Developer Web Console | Not Included | Included | N/A | Developer Application Catalog | Not Included | Included | N/A | Source to Image and Builder Automation (Tekton) | Not Included | Included | N/A