OpenShift Container Platform 4.6 Architecture An overview of the architecture for OpenShift Container Platform Last Updated: 2021-09-22 OpenShift Container Platform 4.6 Architecture An overview of the architecture for OpenShift Container Platform Legal Notice Copyright © 2021 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract This document provides an overview of the platform and application architecture in OpenShift Container Platform. Table of Contents Table of Contents .C . H. .A . P. .T .E . R. 1.. .O . .P . E. N. S. H. I.F .T . .C . O. N. .T . A. .I N. .E . R. P. .L .A . T. .F . O. .R . M. .A . R. C. H. .I T. .E .C . T. .U . R. .E . .4 . 1.1. INTRODUCTION TO OPENSHIFT CONTAINER PLATFORM 4 1.1.1. About Kubernetes 4 1.1.2. The benefits of containerized applications 4 1.1.2.1. Operating system benefits 4 1.1.2.2. Deployment and scaling benefits 5 1.1.3. OpenShift Container Platform overview 5 1.1.3.1. Custom operating system 5 1.1.3.2. Simplified installation and update process 6 1.1.3.3. Other key features 6 1.1.3.4. OpenShift Container Platform lifecycle 6 1.1.4. Internet access for OpenShift Container Platform 7 .C . H. .A . P. .T .E . R. 2. I.N . .S .T . A. .L . L. .A .T . I.O . .N . .A . N. .D . .U . P. .D . .A .T . E. 8. 2.1. OPENSHIFT CONTAINER PLATFORM INSTALLATION OVERVIEW 8 2.1.1. Available platforms 9 2.1.2. Installation process 11 The installation process with installer-provisioned infrastructure 12 The installation process with user-provisioned infrastructure 12 Installation process details 12 Installation scope 14 2.2. ABOUT THE OPENSHIFT UPDATE SERVICE 14 2.3. SUPPORT POLICY FOR UNMANAGED OPERATORS 15 2.4. NEXT STEPS 16 .C . H. .A . P. .T .E . R. 3. T. .H . E. O. P. E. .N . S. .H . I.F . T. C. .O . N. T. A. .I .N . E. .R . P. .L . A. .T . F. O. R. .M . .C . O. N. .T . R. .O . L. P. .L .A . N. E. 1. 7. 3.1. UNDERSTANDING THE OPENSHIFT CONTAINER PLATFORM CONTROL PLANE 17 3.1.1. Node configuration management with machine config pools 17 3.1.2. Machine roles in OpenShift Container Platform 18 3.1.2.1. Cluster workers 18 3.1.2.2. Cluster masters 18 3.1.3. Operators in OpenShift Container Platform 20 3.1.3.1. Platform Operators in OpenShift Container Platform 21 3.1.3.2. Operators managed by OLM 21 3.1.3.3. About the OpenShift Update Service 21 3.1.3.4. Understanding the Machine Config Operator 22 .C . H. .A . P. .T .E . R. 4. .U . N. .D . E. .R . S. .T .A . N. .D . .I N. .G . .O . .P . E. .N . S. H. I.F .T . .C . O. N. .T . A. .I N. .E . R. P. .L .A . T. .F . O. .R . M. .D . E. .V . E. L. .O . P. .M . .E . N. .T . .2 . 4. 4.1. ABOUT DEVELOPING CONTAINERIZED APPLICATIONS 24 4.2. BUILDING A SIMPLE CONTAINER 24 4.2.1. Container build tool options 25 4.2.2. Base image options 26 4.2.3. Registry options 27 4.3. CREATING A KUBERNETES MANIFEST FOR OPENSHIFT CONTAINER PLATFORM 27 4.3.1. About Kubernetes pods and services 28 4.3.2. Application types 28 4.3.3. Available supporting components 29 4.3.4. Applying the manifest 29 4.3.5. Next steps 30 4.4. DEVELOP FOR OPERATORS 30 .C . H. .A . P. .T .E . R. 5. R. .E . D. H. .A . T. E. .N . T. .E .R . P. .R . I.S . E. L. I.N . .U . X. C. .O . R. .E . O. .S . .( .R . H. .C . O. .S . ). 3. .1 . 1 OpenShift Container Platform 4.6 Architecture 5.1. ABOUT RHCOS 31 5.1.1. Key RHCOS features 31 5.1.2. Choosing how to configure RHCOS 32 5.1.3. Choosing how to configure RHCOS 33 5.1.4. About Ignition 33 5.1.4.1. How Ignition works 34 5.1.4.2. The Ignition sequence 35 5.2. VIEWING IGNITION CONFIGURATION FILES 35 5.3. CHANGING IGNITION CONFIGS AFTER INSTALLATION 37 .C . H. .A . P. .T .E . R. 6. .T .H . .E . C. .I /. .C . D. M. E. T. .H . O. D. .O . L. .O . G. Y. A. .N . D. P. .R . A. .C . T. .I C. .E . .3 . 9. 6.1. CI/CD FOR CLUSTER ADMINISTRATION AND APPLICATION CONFIGURATION MANAGEMENT 39 6.2. THE GITOPS METHODOLOGY AND PRACTICE 39 6.2.1. GitOps for single-cluster and multi-cluster administration 39 6.2.2. GitOps for application configuration management 40 6.2.3. GitOps technology providers and integrators 40 .C . H. .A . P. .T .E . R. 7. U. .S . I.N . .G . .A . R. .G . O. C. .D . .W . .I T. .H . .O . P. .E . N. .S . H. .I F. .T . .C . O. .N . .T .A . I.N . .E .R . .P . L. .A . T. F. .O . .R .M . 4. .1 . 7.1. WHAT DOES ARGOCD DO? 41 7.2. STATEMENT OF SUPPORT 41 7.3. ARGOCD DOCUMENTATION 41 .C . H. .A . P. .T .E . R. 8. .A . D. .M . .I S. S. .I O. N. P. .L .U . .G . -. I.N . S. .4 . 2. 8.1. ABOUT ADMISSION PLUG-INS 42 8.2. DEFAULT ADMISSION PLUG-INS 42 8.3. WEBHOOK ADMISSION PLUG-INS 45 8.4. TYPES OF WEBHOOK ADMISSION PLUG-INS 46 8.4.1. Mutating admission plug-in 46 8.4.2. Validating admission plug-in 47 8.5. CONFIGURING DYNAMIC ADMISSION 48 8.6. ADDITIONAL RESOURCES 56 2 Table of Contents 3 OpenShift Container Platform 4.6 Architecture CHAPTER 1. OPENSHIFT CONTAINER PLATFORM ARCHITECTURE 1.1. INTRODUCTION TO OPENSHIFT CONTAINER PLATFORM OpenShift Container Platform is a platform for developing and running containerized applications. It is designed to allow applications and the data centers that support them to expand from just a few machines and applications to thousands of machines that serve millions of clients. With its foundation in Kubernetes, OpenShift Container Platform incorporates the same technology that serves as the engine for massive telecommunications, streaming video, gaming, banking, and other applications. Its implementation in open Red Hat technologies lets you extend your containerized applications beyond a single cloud to on-premise and multi-cloud environments. 1.1.1. About Kubernetes Although container images and the containers that run from them are the primary building blocks for modern application development, to run them at scale requires a reliable and flexible distribution system. Kubernetes is the defacto standard for orchestrating containers. Kubernetes is an open source container orchestration engine for automating deployment, scaling, and management of containerized applications. The general concept of Kubernetes is fairly simple: Start with one or more worker nodes to run the container workloads. Manage the deployment of those workloads from one or more control plane nodes (also known as the master nodes). Wrap containers in a deployment unit called a pod. Using pods provides extra metadata with the container and offers the ability to group several containers in a single deployment entity. Create special kinds of assets. For example, services are represented by a set of pods and a policy that defines how they are accessed. This policy allows containers to connect to the services that they need even if they do not have the specific IP addresses for the services. Replication controllers are another special asset that indicates how many pod replicas are required to run at a time. You can use this capability to automatically scale your application to adapt to its current demand. In only a few years, Kubernetes has seen massive cloud and on-premise adoption. The open source development model allows many people to extend Kubernetes by implementing different technologies for components such as networking, storage, and authentication.