Last active
January 18, 2025 13:03
-
-
Save manisnesan/21ca5f76a683b85e119c57aa0772fc35 to your computer and use it in GitHub Desktop.
URL to Markdown conversion with Jina Reader API and Docling
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| { | |
| "cells": [ | |
| { | |
| "cell_type": "markdown", | |
| "metadata": { | |
| "id": "view-in-github", | |
| "colab_type": "text" | |
| }, | |
| "source": [ | |
| "<a href=\"https://colab.research.google.com/gist/manisnesan/21ca5f76a683b85e119c57aa0772fc35/scratchpad.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>" | |
| ] | |
| }, | |
| { | |
| "cell_type": "markdown", | |
| "source": [ | |
| "## Jina AI Reader" | |
| ], | |
| "metadata": { | |
| "id": "6Awx5baee3ob" | |
| } | |
| }, | |
| { | |
| "cell_type": "code", | |
| "execution_count": 1, | |
| "metadata": { | |
| "colab": { | |
| "base_uri": "https://localhost:8080/" | |
| }, | |
| "id": "lIYdn1woOS1n", | |
| "outputId": "29e55070-ab0e-48b7-be72-5513ce68f988" | |
| }, | |
| "outputs": [ | |
| { | |
| "output_type": "stream", | |
| "name": "stdout", | |
| "text": [ | |
| "Title: STEM camp | Girls Rock Math\n", | |
| "\n", | |
| "URL Source: https://girlsrockmath.org/in-person-camp.php\n", | |
| "\n", | |
| "Markdown Content:\n", | |
| "STEM camp | Girls Rock Math | Seattle\n", | |
| "===============\n", | |
| "\n", | |
| "* [206-408-8078](tel:206-408-8078)\n", | |
| "* [camp@girlsrockmath.org](mailto:camp@girlsrockmath.org)\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/index.php)\n", | |
| "\n", | |
| "* Summer Camp\n", | |
| " \n", | |
| " * [Elementary Camps](https://girlsrockmath.org/in-person-camp.php)\n", | |
| " * [Middle School Camps](https://girlsrockmath.org/middle-school-camps.php)\n", | |
| " * [Life at Camp](https://girlsrockmath.org/life-at-camp.php)\n", | |
| " * [FAQ](https://girlsrockmath.org/summer-faq.php)\n", | |
| " * [Policies](https://girlsrockmath.org/camp-policies.php)\n", | |
| " \n", | |
| "* Locations\n", | |
| " \n", | |
| " * [Washington](https://girlsrockmath.org/locations.php)\n", | |
| " * [California](https://girlsrockmath.org/california.php)\n", | |
| " \n", | |
| "* [Register](https://girlsrockmath.org/register.php)\n", | |
| "* Mission\n", | |
| " \n", | |
| " * [What We Do](https://girlsrockmath.org/prospective-families.php)\n", | |
| " * [Scholarships](https://girlsrockmath.org/scholarships.php)\n", | |
| " * [Donate](https://girlsrockmath.org/donate.php)\n", | |
| " \n", | |
| "* Join our Team\n", | |
| " \n", | |
| " * [Teen Leadership](https://girlsrockmath.org/volunteer.php)\n", | |
| " * [Middle School](https://girlsrockmath.org/middle-school-camps.php)\n", | |
| " * [Employment](https://girlsrockmath.org/employment.php)\n", | |
| " * [Teaching Fellowships](https://girlsrockmath.org/teaching-fellowships.php)\n", | |
| " \n", | |
| "* Connect\n", | |
| " \n", | |
| " * [About Us](https://girlsrockmath.org/contact.php)\n", | |
| " * [Bookstore](https://girlsrockmath.org/bookstore.php)\n", | |
| " \n", | |
| "\n", | |
| "* [](https://www.facebook.com/girlsrockmath)\n", | |
| "* [](https://twitter.com/girlsrockmath)\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/index.php)\n", | |
| "\n", | |
| "* [](https://www.youtube.com/channel/UCp79aJQWe4hGl_EbTblXneA)\n", | |
| "* [](https://www.instagram.com/girlsrockmath/)\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/index.php)\n", | |
| "\n", | |
| "* Summer Camp\n", | |
| " \n", | |
| " * [Elementary Camps](https://girlsrockmath.org/in-person-camp.php)\n", | |
| " * [Middle School Camps](https://girlsrockmath.org/middle-school-camps.php)\n", | |
| " * [Life at Camp](https://girlsrockmath.org/life-at-camp.php)\n", | |
| " * [FAQ](https://girlsrockmath.org/summer-faq.php)\n", | |
| " * [Policies](https://girlsrockmath.org/camp-policies.php)\n", | |
| " \n", | |
| "* Locations\n", | |
| " \n", | |
| " * [Washington](https://girlsrockmath.org/locations.php)\n", | |
| " * [California](https://girlsrockmath.org/california.php)\n", | |
| " \n", | |
| "* [Register](https://girlsrockmath.org/register.php)\n", | |
| "* Mission\n", | |
| " \n", | |
| " * [What We Do](https://girlsrockmath.org/prospective-families.php)\n", | |
| " * [Scholarships](https://girlsrockmath.org/scholarships.php)\n", | |
| " * [Donate](https://girlsrockmath.org/donate.php)\n", | |
| " \n", | |
| "* Join our Team\n", | |
| " \n", | |
| " * [Teen Leadership](https://girlsrockmath.org/volunteer.php)\n", | |
| " * [Middle School](https://girlsrockmath.org/middle-school-camps.php)\n", | |
| " * [Employment](https://girlsrockmath.org/employment.php)\n", | |
| " * [Teaching Fellowships](https://girlsrockmath.org/teaching-fellowships.php)\n", | |
| " \n", | |
| "* Connect\n", | |
| " \n", | |
| " * [About Us](https://girlsrockmath.org/contact.php)\n", | |
| " * [Bookstore](https://girlsrockmath.org/bookstore.php)\n", | |
| " \n", | |
| "\n", | |
| "[Register Now](https://girlsrockmath.org/register.php)\n", | |
| "\n", | |
| "Summer Camp\n", | |
| "===========\n", | |
| "\n", | |
| "Alumni Registration Period runs from January 12-19 \n", | |
| "New Family Registration Opens January 26 \n", | |
| " \n", | |
| "\n", | |
| "[See Our Summer Schedule](https://drive.google.com/file/d/1A2hHDQ_fyNCHrAphR46U878NNk71u7RY/view?usp=sharing)\n", | |
| "\n", | |
| " \n", | |
| "\n", | |
| "Check out our Awesome Camp Themes\n", | |
| "---------------------------------\n", | |
| "\n", | |
| " \n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "PRIMARY:\n", | |
| "--------\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/alice.php)[](https://girlsrockmath.org/dramatic-mathematics.php)[](https://girlsrockmath.org/girls-count.php)[](https://girlsrockmath.org/mathmagical.php)[](https://girlsrockmath.org/math-explorers.php)[](https://girlsrockmath.org/mathily-ever-after.php)[](https://girlsrockmath.org/mini-math.php)[](https://girlsrockmath.org/pawsitive.php)[](https://girlsrockmath.org/camp-smart.php)[](https://girlsrockmath.org/crafty-math.php)[](https://girlsrockmath.org/flower-powers.php)[](https://girlsrockmath.org/imaginary-numbers.php)[](https://girlsrockmath.org/math-magic.php)[](https://girlsrockmath.org/math-moves.php)[](https://girlsrockmath.org/math-my-style.php)[](https://girlsrockmath.org/splash-into-math.php)\n", | |
| "\n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "INTERMEDIATE:\n", | |
| "-------------\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/bead-dazzling.php)[](https://girlsrockmath.org/girl-power.php)[](https://girlsrockmath.org/infinitely-artistic.php)[](https://girlsrockmath.org/intergalactic-mathematics.php)[](https://girlsrockmath.org/mystical-math.php)[](https://girlsrockmath.org/naturally-mathematical.php)[](https://girlsrockmath.org/painting-by-numbers.php)[](https://girlsrockmath.org/prints-and-patterns.php)[](https://girlsrockmath.org/ancient-adventures.php)[](https://girlsrockmath.org/arts-and-maths.php)[](https://girlsrockmath.org/fasionably-smart.php)[](https://girlsrockmath.org/get-a-clue.php)[](https://girlsrockmath.org/math-it.php)[](https://girlsrockmath.org/molecular-math.php)[](https://girlsrockmath.org/shrinky-dink-lab.php)\n", | |
| "\n", | |
| "Ready to Register?\n", | |
| "------------------\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/register.php)\n", | |
| "\n", | |
| "[](https://girlsrockmath.org/index.php)\n", | |
| "\n", | |
| "At Girls Rock Math we reinforce that math is fun and imaginative. We aim to boost interest and confidence in mathematics. Learning at Girls Rock Math allows for collaboration, emphasizing persistence, strategy building and mathematical thinking.\n", | |
| "\n", | |
| "#### Contact\n", | |
| "\n", | |
| "* [206-408-8078](tel:206-408-8078)\n", | |
| "* [camp@girlsrockmath.org](mailto:camp@girlsrockmath.org)\n", | |
| "* 3201 E. Republican Street, Seattle, WA 98112\n", | |
| "\n", | |
| " \n", | |
| "\n", | |
| "Subscribe\n", | |
| "---------\n", | |
| "\n", | |
| "Email Address \\*\n", | |
| "\n", | |
| "* [](https://www.facebook.com/girlsrockmath)\n", | |
| "* [](https://twitter.com/girlsrockmath)\n", | |
| "* [](https://www.youtube.com/channel/UC3ExhYSVl8oVtk-KzFBJOtQ)\n", | |
| "* [](https://www.instagram.com/girlsrockmath/)\n", | |
| "\n", | |
| "Copyright © 2025 by Girls Rock Math - Website by [Octave Marketing Agency](https://octave-marketing.com/) \n", | |
| "Photography provided by Colleen Dishy \n", | |
| "[Privacy Policy](https://girlsrockmath.org/privacy-policy.php) | [Terms & Conditions](https://girlsrockmath.org/terms.php) | [Policies](https://girlsrockmath.org/camp-policies.php) | [Staff Site](https://jes8103.wixsite.com/my-site-1)\n", | |
| "\n", | |
| " \n", | |
| "\n", | |
| " \n", | |
| "\n", | |
| "### Recent Search Keywords\n", | |
| "\n", | |
| "* [Business](https://girlsrockmath.org/in-person-camp.php#)\n", | |
| "* [Web Development](https://girlsrockmath.org/in-person-camp.php#)\n", | |
| "* [SEO](https://girlsrockmath.org/in-person-camp.php#)\n", | |
| "* [Logistics](https://girlsrockmath.org/in-person-camp.php#)\n", | |
| "* [Freedom](https://girlsrockmath.org/in-person-camp.php#)\n", | |
| "\n" | |
| ] | |
| } | |
| ], | |
| "source": [ | |
| "from httpx import get as getx\n", | |
| "\n", | |
| "r = getx('https://r.jina.ai/https://girlsrockmath.org/in-person-camp.php')\n", | |
| "print(r.text)" | |
| ] | |
| }, | |
| { | |
| "cell_type": "code", | |
| "source": [ | |
| "from httpx import get as getx\n", | |
| "\n", | |
| "r = getx('https://r.jina.ai/https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-lifecycle-policy_rosa-hcp-upgrading')\n", | |
| "print(r.text)" | |
| ], | |
| "metadata": { | |
| "colab": { | |
| "base_uri": "https://localhost:8080/" | |
| }, | |
| "id": "jdA4LwSmedZb", | |
| "outputId": "2269465c-a20a-4372-916f-0173005269e1" | |
| }, | |
| "execution_count": 2, | |
| "outputs": [ | |
| { | |
| "output_type": "stream", | |
| "name": "stdout", | |
| "text": [ | |
| "Title: Chapter 1. Upgrading ROSA with HCP clusters\n", | |
| "\n", | |
| "URL Source: https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading\n", | |
| "\n", | |
| "Markdown Content:\n", | |
| "Chapter 1. Upgrading ROSA with HCP clusters | Red Hat Product Documentation\n", | |
| "===============\n", | |
| " \n", | |
| "\n", | |
| "[Skip to navigation](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#pfe-navigation)[Skip to content](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#main-content)\n", | |
| "\n", | |
| "Featured links\n", | |
| "\n", | |
| "* [Support](https://access.redhat.com/)\n", | |
| "* [Console](https://console.redhat.com/)\n", | |
| "* [Developers](https://developers.redhat.com/)\n", | |
| "* [Start a trial](https://www.redhat.com/en/products/trials)\n", | |
| "* All Red Hat\n", | |
| " \n", | |
| " * For customers\n", | |
| " * [Customer support](https://access.redhat.com/support)\n", | |
| " * [Documentation](https://docs.redhat.com/products)\n", | |
| " * [Support Cases](https://access.redhat.com/support/cases)\n", | |
| " * [Subscription management](https://access.redhat.com/management)\n", | |
| " * [Red Hat Ecosystem Catalog](https://catalog.redhat.com/)\n", | |
| " * [Find a partner](https://catalog.redhat.com/partners)\n", | |
| " * For partners\n", | |
| " * [Partner login](https://connect.redhat.com/login)\n", | |
| " * [Partner support](https://connect.redhat.com/en/support)\n", | |
| " * [Become a partner](https://connect.redhat.com/)\n", | |
| " * Try, buy, & sell\n", | |
| " * [Red Hat Marketplace](https://marketplace.redhat.com/en-us)\n", | |
| " * [Red Hat Store](https://www.redhat.com/en/store)\n", | |
| " * [Contact Sales](https://www.redhat.com/en/contact)\n", | |
| " * [Start a trial](https://www.redhat.com/en/products/trials)\n", | |
| " * Learning resources\n", | |
| " * [Training and certification](https://www.redhat.com/en/services/training-and-certification)\n", | |
| " * [For developers](https://developers.redhat.com/)\n", | |
| " * [Hybrid cloud learning hub](https://cloud.redhat.com/learn)\n", | |
| " * [Interactive labs](https://www.redhat.com/en/interactive-labs)\n", | |
| " * [Learning community](https://learn.redhat.com/)\n", | |
| " * [Red Hat TV](https://www.redhat.com/en/tv)\n", | |
| " * Open source communities\n", | |
| " * [Ansible](https://www.ansible.com/community)\n", | |
| " * [For system administrators](https://www.redhat.com/sysadmin/)\n", | |
| " * [For architects](https://www.redhat.com/architect/)\n", | |
| " \n", | |
| "\n", | |
| "[](https://docs.redhat.com/en)\n", | |
| "\n", | |
| "\n", | |
| "\n", | |
| "[Support](https://access.redhat.com/)[Console](https://console.redhat.com/)[Developers](https://developers.redhat.com/)[Start a trial](https://www.redhat.com/en/products/trials)[Contact](https://www.redhat.com/en/contact)\n", | |
| "\n", | |
| "Select your language\n", | |
| "\n", | |
| "1. [Home](https://docs.redhat.com/)\n", | |
| "2. [Products](https://docs.redhat.com/en/products)\n", | |
| "3. [Red Hat OpenShift Service on AWS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/)\n", | |
| "4. [4](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/)\n", | |
| "5. [Upgrading](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/)\n", | |
| "6. Chapter 1. Upgrading ROSA with HCP clusters\n", | |
| "\n", | |
| "Open Table of contents\n", | |
| "\n", | |
| "Open page settings\n", | |
| "\n", | |
| "Red Hat OpenShift Service on AWS\n", | |
| "================================\n", | |
| "\n", | |
| "Format\n", | |
| "\n", | |
| "Jump to section\n", | |
| "\n", | |
| "Red Hat OpenShift Service on AWS\n", | |
| "================================\n", | |
| "\n", | |
| "1. Get started\n", | |
| " \n", | |
| " 1. About\n", | |
| " \n", | |
| " 1. [About](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/about/index)\n", | |
| " 2. [Red Hat OpenShift Service on AWS 4 Documentation](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/about/welcome-index)\n", | |
| " 3. [Learn more about ROSA with HCP](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/about/about-hcp)\n", | |
| " 4. [AWS STS and ROSA with HCP explained](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/about/cloud-experts-rosa-hcp-sts-explained)\n", | |
| " \n", | |
| " 2. What’s new\n", | |
| " \n", | |
| " 1. [What’s new](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/whats_new/index)\n", | |
| " 2. [What’s new with Red Hat OpenShift Service on AWS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/whats_new/rosa-whats-new)\n", | |
| " \n", | |
| " 3. Getting started\n", | |
| " \n", | |
| " 1. [Getting started](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/getting_started/index)\n", | |
| " 2. [Red Hat OpenShift Service on AWS quick start guide](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/getting_started/rosa-quickstart-guide-ui)\n", | |
| " 3. [Comprehensive guide to getting started with Red Hat OpenShift Service on AWS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/getting_started/rosa-getting-started)\n", | |
| " 4. [Understanding the ROSA with STS deployment workflow](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/getting_started/rosa-sts-understanding-the-deployment-workflow)\n", | |
| " \n", | |
| " 4. Introduction to ROSA\n", | |
| " \n", | |
| " 1. [Introduction to ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/introduction_to_rosa/index)\n", | |
| " 2. [Understanding ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/introduction_to_rosa/rosa-understanding)\n", | |
| " 3. [Policies and service definition](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/introduction_to_rosa/policies-and-service-definition)\n", | |
| " 4. [About IAM resources for ROSA clusters that use STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/introduction_to_rosa/rosa-sts-about-iam-resources)\n", | |
| " 5. [OpenID Connect Overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/introduction_to_rosa/rosa-oidc-overview)\n", | |
| " \n", | |
| " 5. Architecture\n", | |
| " \n", | |
| " 1. [Architecture](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/index)\n", | |
| " 2. [Architecture overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/architecture-overview)\n", | |
| " 3. [Red Hat OpenShift Service on AWS architecture](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/architecture)\n", | |
| " 4. [Architecture models](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/rosa-architecture-models)\n", | |
| " 5. [Control plane architecture](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/control-plane)\n", | |
| " 6. [NVIDIA GPU architecture overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/nvidia-gpu-architecture-overview)\n", | |
| " 7. [Understanding Red Hat OpenShift Service on AWS development](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/understanding-development)\n", | |
| " 8. [Admission plugins](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/architecture/admission-plug-ins)\n", | |
| " \n", | |
| " 6. Tutorials\n", | |
| " \n", | |
| " 1. [Tutorials](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/index)\n", | |
| " 2. [Tutorials overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/tutorials-overview)\n", | |
| " 3. [Tutorial: ROSA with HCP activation and account linking](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/rosa-with-hcp-activation-and-account-linking)\n", | |
| " 4. [Tutorial: ROSA with HCP private offer acceptance and sharing](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/rosa-with-hcp-private-offer-acceptance-and-sharing)\n", | |
| " 5. [Tutorial: Verifying Permissions for a ROSA STS Deployment](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/rosa-mobb-verify-permissions-sts-deployment)\n", | |
| " 6. [Tutorial: Deploying ROSA with a Custom DNS Resolver](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-custom-dns-resolver)\n", | |
| " 7. [Tutorial: Using AWS WAF and Amazon CloudFront to protect ROSA workloads](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-using-cloudfront-and-waf)\n", | |
| " 8. [Tutorial: Using AWS WAF and AWS ALBs to protect ROSA workloads](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-using-alb-and-waf)\n", | |
| " 9. [Tutorial: Deploying OpenShift API for Data Protection on a ROSA cluster](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-deploy-api-data-protection)\n", | |
| " 10. [Tutorial: AWS Load Balancer Operator on ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-aws-load-balancer-operator)\n", | |
| " 11. [Tutorial: Configuring Microsoft Entra ID (formerly Azure Active Directory) as an identity provider](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-entra-id-idp)\n", | |
| " 12. [Tutorial: Using AWS Secrets Manager CSI on ROSA with STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-aws-secret-manager)\n", | |
| " 13. [Tutorial: Using AWS Controllers for Kubernetes on ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/using-aws-controllers-for-kubernetes-on-rosa)\n", | |
| " 14. [Tutorial: Deploying the External DNS Operator on ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-external-dns)\n", | |
| " 15. [Tutorial: Dynamically issuing certificates using the cert-manager Operator on ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-dynamic-certificate-custom-domain)\n", | |
| " 16. [Tutorial: Assigning a consistent egress IP for external traffic](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-consistent-egress-ip)\n", | |
| " 17. [Tutorial: Updating component routes with custom domains and TLS certificates](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/cloud-experts-update-component-routes)\n", | |
| " 18. [Getting started with ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/getting-started-with-rosa)\n", | |
| " 19. [Deploying an application](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/tutorials/deploying-an-application)\n", | |
| " \n", | |
| " 7. Prepare your environment\n", | |
| " \n", | |
| " 1. [Prepare your environment](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/index)\n", | |
| " 2. [Prerequisites checklist for deploying ROSA using STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-cloud-expert-prereq-checklist)\n", | |
| " 3. [Detailed requirements for deploying ROSA using STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-sts-aws-prereqs)\n", | |
| " 4. [ROSA IAM role resources](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-sts-ocm-role)\n", | |
| " 5. [Limits and scalability](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-limits-scalability)\n", | |
| " 6. [ROSA with HCP limits and scalability](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-hcp-limits-scalability)\n", | |
| " 7. [Planning your environment](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-planning-environment)\n", | |
| " 8. [Required AWS service quotas](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-sts-required-aws-service-quotas)\n", | |
| " 9. [Setting up the environment for using STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/prepare_your_environment/rosa-sts-setting-up-environment)\n", | |
| " \n", | |
| " \n", | |
| "2. Create clusters\n", | |
| " \n", | |
| " 1. Install ROSA Classic clusters\n", | |
| " \n", | |
| " 1. [Install ROSA Classic clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/index)\n", | |
| " 2. [Creating a ROSA cluster with STS using the default options](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-creating-a-cluster-quickly)\n", | |
| " 3. [Creating a ROSA cluster with STS using customizations](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-creating-a-cluster-with-customizations)\n", | |
| " 4. [Creating a ROSA (classic architecture) cluster using Terraform](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/creating-a-rosa-classic-architecture-cluster-using-terraform)\n", | |
| " 5. [Interactive cluster creation mode reference](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-interactive-mode-reference)\n", | |
| " 6. [Creating an AWS PrivateLink cluster on ROSA](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-aws-privatelink-creating-cluster)\n", | |
| " 7. [Configuring a shared VPC for ROSA clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-shared-vpc-config)\n", | |
| " 8. [Accessing a ROSA cluster](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-accessing-cluster)\n", | |
| " 9. [Configuring identity providers for STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-config-identity-providers)\n", | |
| " 10. [Revoking access to a ROSA cluster](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-deleting-access-cluster)\n", | |
| " 11. [Deleting a ROSA cluster](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-deleting-cluster)\n", | |
| " 12. [Deploying ROSA without AWS STS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/deploying-rosa-without-aws-sts)\n", | |
| " \n", | |
| " 2. Install ROSA with HCP clusters\n", | |
| " \n", | |
| " 1. [Install ROSA with HCP clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/index)\n", | |
| " 2. [Creating ROSA with HCP clusters using the default options](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/rosa-hcp-sts-creating-a-cluster-quickly)\n", | |
| " 3. [Creating a ROSA cluster using Terraform](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/creating-a-rosa-cluster-using-terraform)\n", | |
| " 4. [Creating ROSA with HCP clusters using a custom AWS KMS encryption key](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/rosa-hcp-creating-cluster-with-aws-kms-key)\n", | |
| " 5. [Creating a private cluster on ROSA with HCP](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/rosa-hcp-aws-private-creating-cluster)\n", | |
| " 6. [Creating ROSA with HCP clusters with external authentication](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/rosa-hcp-sts-creating-a-cluster-ext-auth)\n", | |
| " 7. [ROSA with HCP clusters without a CNI plugin](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/rosa-hcp-cluster-no-cli)\n", | |
| " 8. [Deleting a ROSA with HCP cluster](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_rosa_with_hcp_clusters/rosa-hcp-deleting-cluster)\n", | |
| " \n", | |
| " 3. Support\n", | |
| " \n", | |
| " 1. [Support](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/index)\n", | |
| " 2. [Support overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/support-overview)\n", | |
| " 3. [Managing your cluster resources](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/managing-cluster-resources)\n", | |
| " 4. [Approved Access](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/approved-access)\n", | |
| " 5. [Getting support](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/getting-support)\n", | |
| " 6. [Remote health monitoring with connected clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/remote-health-monitoring-with-connected-clusters)\n", | |
| " 7. [Gathering data about your cluster](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/gathering-cluster-data)\n", | |
| " 8. [Summarizing cluster specifications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/summarizing-cluster-specifications)\n", | |
| " 9. [Troubleshooting](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/support/troubleshooting)\n", | |
| " \n", | |
| " 4. Web console\n", | |
| " \n", | |
| " 1. [Web console](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/index)\n", | |
| " 2. [Web Console Overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/web-console-overview)\n", | |
| " 3. [Accessing the web console](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/web-console)\n", | |
| " 4. [Using the Red Hat OpenShift Service on AWS dashboard to get cluster information](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/using-dashboard-to-get-cluster-info)\n", | |
| " 5. [Dynamic plugins](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/dynamic-plugins)\n", | |
| " 6. [Web terminal](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/web-terminal)\n", | |
| " 7. [About quick start tutorials](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/web_console/creating-quick-start-tutorials)\n", | |
| " \n", | |
| " \n", | |
| "3. Update clusters\n", | |
| " \n", | |
| " 1. Upgrading\n", | |
| " \n", | |
| " 1. [Upgrading](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/index)\n", | |
| " 2. [Upgrading ROSA with HCP clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading)\n", | |
| " 3. [Upgrading ROSA (classic architecture) clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-upgrading-sts)\n", | |
| " \n", | |
| " 2. Logging\n", | |
| " \n", | |
| " 1. [Logging](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/index)\n", | |
| " 2. [Release notes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/release-notes)\n", | |
| " 3. [Support](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/support)\n", | |
| " 4. [Troubleshooting logging](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/troubleshooting-logging)\n", | |
| " 5. [About Logging](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/cluster-logging)\n", | |
| " 6. [Installing Logging](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/cluster-logging-deploying)\n", | |
| " 7. [Updating Logging](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/cluster-logging-upgrading)\n", | |
| " 8. [Visualizing logs](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/visualizing-logs)\n", | |
| " 9. [Configuring your Logging deployment](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/configuring-your-logging-deployment)\n", | |
| " 10. [Log collection and forwarding](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/log-collection-and-forwarding)\n", | |
| " 11. [Log storage](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/log-storage)\n", | |
| " 12. [Logging alerts](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/logging-alerts)\n", | |
| " 13. [Performance and reliability tuning](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/performance-and-reliability-tuning)\n", | |
| " 14. [Scheduling resources](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/scheduling-resources)\n", | |
| " 15. [Uninstalling Logging](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/cluster-logging-uninstall)\n", | |
| " 16. [Log Record Fields](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/cluster-logging-exported-fields)\n", | |
| " 17. [tags](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/tags)\n", | |
| " 18. [kubernetes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/cluster-logging-exported-fields-kubernetes_cluster-logging-exported-fields)\n", | |
| " 19. [OpenShift](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/openshift)\n", | |
| " 20. [API reference](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/api-reference)\n", | |
| " 21. [Glossary](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/logging/openshift-logging-common-terms)\n", | |
| " \n", | |
| " \n", | |
| "4. Manage clusters\n", | |
| " \n", | |
| " 1. Cluster administration\n", | |
| " \n", | |
| " 1. [Cluster administration](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cluster_administration/index)\n", | |
| " 2. [Cluster notifications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cluster_administration/rosa-cluster-notifications)\n", | |
| " 3. [Configuring private connections](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cluster_administration/configuring-private-connections)\n", | |
| " 4. [Cluster autoscaling](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cluster_administration/rosa-cluster-autoscaling)\n", | |
| " 5. [Manage nodes using machine pools](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cluster_administration/manage-nodes-using-machine-pools)\n", | |
| " 6. [Configuring PID limits](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cluster_administration/rosa-configuring-pid-limits)\n", | |
| " \n", | |
| " 2. Red Hat OpenShift Cluster Manager\n", | |
| " \n", | |
| " 1. [Red Hat OpenShift Cluster Manager](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/red_hat_openshift_cluster_manager/index)\n", | |
| " 2. [Red Hat OpenShift Cluster Manager](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/red_hat_openshift_cluster_manager/ocm-overview)\n", | |
| " \n", | |
| " 3. CLI tools\n", | |
| " \n", | |
| " 1. [CLI tools](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/index)\n", | |
| " 2. [Red Hat OpenShift Service on AWS CLI tools overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/cli-tools-overview)\n", | |
| " 3. [OpenShift CLI (oc)](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/openshift-cli-oc)\n", | |
| " 4. [Important update on odo](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/developer-cli-odo)\n", | |
| " 5. [Knative CLI for use with OpenShift Serverless](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/kn-cli-tools)\n", | |
| " 6. [Pipelines CLI (tkn)](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/pipelines-cli-tkn)\n", | |
| " 7. [opm CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/opm-cli)\n", | |
| " 8. [Operator SDK](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/operator-sdk)\n", | |
| " 9. [ROSA CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cli_tools/rosa-cli)\n", | |
| " \n", | |
| " 4. Storage\n", | |
| " \n", | |
| " 1. [Storage](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/index)\n", | |
| " 2. [Red Hat OpenShift Service on AWS storage overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/storage-overview)\n", | |
| " 3. [Understanding ephemeral storage](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/understanding-ephemeral-storage)\n", | |
| " 4. [Understanding persistent storage](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/understanding-persistent-storage)\n", | |
| " 5. [Configuring persistent storage](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/configuring-persistent-storage)\n", | |
| " 6. [Using Container Storage Interface (CSI)](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/using-container-storage-interface-csi)\n", | |
| " 7. [Generic ephemeral volumes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/generic-ephemeral-volumes)\n", | |
| " 8. [Dynamic provisioning](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/storage/dynamic-provisioning)\n", | |
| " \n", | |
| " 5. Networking\n", | |
| " \n", | |
| " 1. [Networking](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/index)\n", | |
| " 2. [About networking](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/about-managed-networking)\n", | |
| " 3. [Networking Operators](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/networking-operators)\n", | |
| " 4. [Network verification for ROSA clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/rosa-network-verification_ingress-node-firewall-operator)\n", | |
| " 5. [Configuring a cluster-wide proxy](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/configuring-a-cluster-wide-proxy)\n", | |
| " 6. [CIDR range definitions](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/cidr-range-definitions)\n", | |
| " 7. [Network security](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/network-security)\n", | |
| " 8. [OVN-Kubernetes network plugin](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/ovn-kubernetes-network-plugin)\n", | |
| " 9. [OpenShift SDN network plugin](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/openshift-sdn-network-plugin)\n", | |
| " 10. [Configuring Routes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/networking/configuring-routes)\n", | |
| " \n", | |
| " 6. Operators\n", | |
| " \n", | |
| " 1. [Operators](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/operators/index)\n", | |
| " 2. [Operators overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/operators/operators-overview)\n", | |
| " 3. [Understanding Operators](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/operators/understanding-operators)\n", | |
| " 4. [User tasks](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/operators/user-tasks)\n", | |
| " 5. [Administrator tasks](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/operators/administrator-tasks)\n", | |
| " 6. [Developing Operators](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/operators/developing-operators)\n", | |
| " \n", | |
| " 7. Nodes\n", | |
| " \n", | |
| " 1. [Nodes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/index)\n", | |
| " 2. [Overview of nodes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/overview-of-nodes)\n", | |
| " 3. [Working with pods](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/working-with-pods)\n", | |
| " 4. [Automatically scaling pods with the Custom Metrics Autoscaler Operator](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/automatically-scaling-pods-with-the-custom-metrics-autoscaler-operator)\n", | |
| " 5. [Controlling pod placement onto nodes (scheduling)](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/controlling-pod-placement-onto-nodes-scheduling)\n", | |
| " 6. [Using jobs and daemon sets](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/using-jobs-and-daemon-sets)\n", | |
| " 7. [Working with nodes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/working-with-nodes)\n", | |
| " 8. [Working with containers](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/working-with-containers)\n", | |
| " 9. [Working with clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/nodes/working-with-clusters)\n", | |
| " \n", | |
| " 8. Backup and restore\n", | |
| " \n", | |
| " 1. [Backup and restore](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/backup_and_restore/index)\n", | |
| " 2. [OADP Application backup and restore](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/backup_and_restore/oadp-application-backup-and-restore)\n", | |
| " \n", | |
| " \n", | |
| "5. Alerts and monitoring\n", | |
| " \n", | |
| " 1. Monitoring\n", | |
| " \n", | |
| " 1. [Monitoring](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/index)\n", | |
| " 2. [Monitoring overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/monitoring-overview)\n", | |
| " 3. [Accessing monitoring for user-defined projects](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/sd-accessing-monitoring-for-user-defined-projects)\n", | |
| " 4. [Configuring the monitoring stack](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/configuring-the-monitoring-stack)\n", | |
| " 5. [Configuring external Alertmanager instances](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/monitoring-configuring-external-alertmanagers_configuring-the-monitoring-stack)\n", | |
| " 6. [Configuring secrets for Alertmanager](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/monitoring-configuring-secrets-for-alertmanager_configuring-the-monitoring-stack)\n", | |
| " 7. [Using pod topology spread constraints for monitoring](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/using-pod-topology-spread-constraints-for-monitoring_configuring-the-monitoring-stack)\n", | |
| " 8. [Disabling monitoring for user-defined projects](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/sd-disabling-monitoring-for-user-defined-projects)\n", | |
| " 9. [Enabling alert routing for user-defined projects](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/enabling-alert-routing-for-user-defined-projects)\n", | |
| " 10. [Managing metrics](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/managing-metrics)\n", | |
| " 11. [Managing alerts](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/managing-alerts)\n", | |
| " 12. [Reviewing monitoring dashboards](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/reviewing-monitoring-dashboards)\n", | |
| " 13. [Accessing monitoring APIs by using the CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/accessing-third-party-monitoring-apis)\n", | |
| " 14. [Troubleshooting monitoring issues](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/troubleshooting-monitoring-issues)\n", | |
| " 15. [Config map reference for the Cluster Monitoring Operator](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/monitoring/config-map-reference-for-the-cluster-monitoring-operator)\n", | |
| " \n", | |
| " \n", | |
| "6. Security and compliance\n", | |
| " \n", | |
| " 1. Authentication and authorization\n", | |
| " \n", | |
| " 1. [Authentication and authorization](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/index)\n", | |
| " 2. [Overview of authentication and authorization](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/overview-of-authentication-authorization)\n", | |
| " 3. [Understanding authentication](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/understanding-authentication)\n", | |
| " 4. [Managing user-owned OAuth access tokens](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/managing-oauth-access-tokens)\n", | |
| " 5. [Configuring identity providers](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/sd-configuring-identity-providers)\n", | |
| " 6. [Using RBAC to define and apply permissions](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/using-rbac)\n", | |
| " 7. [Understanding and creating service accounts](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/understanding-and-creating-service-accounts)\n", | |
| " 8. [Using service accounts in applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/using-service-accounts)\n", | |
| " 9. [Using a service account as an OAuth client](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/using-service-accounts-as-oauth-client)\n", | |
| " 10. [Assuming an AWS IAM role for a service account](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/assuming-an-aws-iam-role-for-a-service-account)\n", | |
| " 11. [Scoping tokens](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/tokens-scoping)\n", | |
| " 12. [Using bound service account tokens](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/bound-service-account-tokens)\n", | |
| " 13. [Managing security context constraints](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/managing-pod-security-policies)\n", | |
| " 14. [Understanding and managing pod security admission](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/understanding-and-managing-pod-security-admission)\n", | |
| " 15. [Syncing LDAP groups](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/authentication_and_authorization/ldap-syncing)\n", | |
| " \n", | |
| " 2. Security and compliance\n", | |
| " \n", | |
| " 1. [Security and compliance](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/security_and_compliance/index)\n", | |
| " 2. [Viewing audit logs](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/security_and_compliance/audit-log-view)\n", | |
| " 3. [Adding additional constraints for IP-based AWS role assumption](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/security_and_compliance/adding-additional-constraints-for-ip-based-aws-role-assumption)\n", | |
| " \n", | |
| " \n", | |
| "7. Develop and deploy applications\n", | |
| " \n", | |
| " 1. Images\n", | |
| " \n", | |
| " 1. [Images](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/index)\n", | |
| " 2. [Overview of images](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/overview-of-images)\n", | |
| " 3. [Overview of the Cluster Samples Operator](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/configuring-samples-operator)\n", | |
| " 4. [Using the Cluster Samples Operator with an alternate registry](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/samples-operator-alt-registry)\n", | |
| " 5. [Creating images](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/creating-images)\n", | |
| " 6. [Managing images](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/managing-images)\n", | |
| " 7. [Managing image streams](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/managing-image-streams)\n", | |
| " 8. [Using image streams with Kubernetes resources](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/using-imagestreams-with-kube-resources)\n", | |
| " 9. [Triggering updates on image stream changes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/triggering-updates-on-imagestream-changes)\n", | |
| " 10. [Image configuration resources (Classic)](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/image-configuration)\n", | |
| " 11. [Image configuration resources for ROSA with HCP](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/image-configuration-hcp)\n", | |
| " 12. [Using templates](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/using-templates)\n", | |
| " 13. [Using Ruby on Rails](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/images/templates-using-ruby-on-rails)\n", | |
| " \n", | |
| " 2. Building applications\n", | |
| " \n", | |
| " 1. [Building applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/index)\n", | |
| " 2. [Building applications overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/building-applications-overview)\n", | |
| " 3. [Projects](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/projects)\n", | |
| " 4. [Creating applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/creating-applications)\n", | |
| " 5. [Viewing application composition by using the Topology view](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/odc-viewing-application-composition-using-topology-view)\n", | |
| " 6. [Working with Helm charts](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/working-with-helm-charts)\n", | |
| " 7. [Deployments](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/deployments)\n", | |
| " 8. [Quotas](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/quotas)\n", | |
| " 9. [Using config maps with applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/config-maps)\n", | |
| " 10. [Monitoring project and application metrics using the Developer perspective](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/odc-monitoring-project-and-application-metrics-using-developer-perspective)\n", | |
| " 11. [Monitoring application health by using health checks](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/application-health)\n", | |
| " 12. [Editing applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/odc-editing-applications)\n", | |
| " 13. [Working with quotas](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/working-with-quotas)\n", | |
| " 14. [Pruning objects to reclaim resources](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/pruning-objects)\n", | |
| " 15. [Idling applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/idling-applications)\n", | |
| " 16. [Deleting applications](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/odc-deleting-applications)\n", | |
| " 17. [Using the Red Hat Marketplace](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/building_applications/red-hat-marketplace)\n", | |
| " \n", | |
| " 3. Application development\n", | |
| " \n", | |
| " 1. [Application development](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/applications/index)\n", | |
| " 2. [Deployments](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/applications/deployments)\n", | |
| " \n", | |
| " 4. Registry\n", | |
| " \n", | |
| " 1. [Registry](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/registry/index)\n", | |
| " 2. [OpenShift image registry overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/registry/registry-overview-1)\n", | |
| " 3. [Image Registry Operator in Red Hat OpenShift Service on AWS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/registry/configuring-registry-operator)\n", | |
| " 4. [Accessing the registry](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/registry/accessing-the-registry)\n", | |
| " \n", | |
| " \n", | |
| "8. CI/CD\n", | |
| " \n", | |
| " 1. CI/CD overview\n", | |
| " \n", | |
| " 1. [CI/CD overview](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cicd_overview/index)\n", | |
| " 2. [About CI/CD](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/cicd_overview/ci-cd-overview)\n", | |
| " \n", | |
| " 2. Builds using Shipwright\n", | |
| " \n", | |
| " 1. [Builds using Shipwright](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_shipwright/index)\n", | |
| " 2. [Overview of Builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_shipwright/overview-openshift-builds)\n", | |
| " \n", | |
| " 3. Builds using BuildConfig\n", | |
| " \n", | |
| " 1. [Builds using BuildConfig](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/index)\n", | |
| " 2. [Understanding image builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/understanding-image-builds)\n", | |
| " 3. [Understanding build configurations](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/understanding-buildconfigs)\n", | |
| " 4. [Creating build inputs](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/creating-build-inputs)\n", | |
| " 5. [Managing build output](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/managing-build-output)\n", | |
| " 6. [Using build strategies](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/build-strategies)\n", | |
| " 7. [Performing and configuring basic builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/basic-build-operations)\n", | |
| " 8. [Triggering and modifying builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/triggering-builds-build-hooks)\n", | |
| " 9. [Performing advanced builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/advanced-build-operations)\n", | |
| " 10. [Using Red Hat subscriptions in builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/running-entitled-builds)\n", | |
| " 11. [Troubleshooting builds](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/builds_using_buildconfig/troubleshooting-builds_running-entitled-builds)\n", | |
| " \n", | |
| " 4. GitOps\n", | |
| " \n", | |
| " 1. [GitOps](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/gitops/index)\n", | |
| " 2. [About Red Hat OpenShift GitOps](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/gitops/about-redhat-openshift-gitops)\n", | |
| " \n", | |
| " 5. Pipelines\n", | |
| " \n", | |
| " 1. [Pipelines](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/pipelines/index)\n", | |
| " 2. [About Red Hat OpenShift Pipelines](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/pipelines/about-pipelines)\n", | |
| " \n", | |
| " 6. Jenkins\n", | |
| " \n", | |
| " 1. [Jenkins](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/jenkins/index)\n", | |
| " 2. [Configuring Jenkins images](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/jenkins/images-other-jenkins)\n", | |
| " 3. [Jenkins agent](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/jenkins/images-other-jenkins-agent)\n", | |
| " 4. [Migrating from Jenkins to OpenShift Pipelines or Tekton](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/jenkins/migrating-from-jenkins-to-openshift-pipelines_images-other-jenkins-agent)\n", | |
| " 5. [Important changes to OpenShift Jenkins images](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/jenkins/important-changes-to-openshift-jenkins-images)\n", | |
| " \n", | |
| " \n", | |
| "9. Integrate with other products and services\n", | |
| " \n", | |
| " 1. Virtualization\n", | |
| " \n", | |
| " 1. [Virtualization](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/index)\n", | |
| " 2. [About](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/about)\n", | |
| " 3. [Getting started](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/getting-started)\n", | |
| " 4. [Installing](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/installing)\n", | |
| " 5. [Post-installation configuration](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/post-installation-configuration)\n", | |
| " 6. [Updating](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/updating)\n", | |
| " 7. [Virtual machines](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/virtual-machines)\n", | |
| " 8. [Networking](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/networking)\n", | |
| " 9. [Storage](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/storage)\n", | |
| " 10. [Live migration](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/live-migration)\n", | |
| " 11. [Nodes](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/nodes)\n", | |
| " 12. [Monitoring](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/monitoring)\n", | |
| " 13. [Support](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/support)\n", | |
| " 14. [Backup and restore](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/virtualization/backup-and-restore)\n", | |
| " \n", | |
| " 2. Add-on services\n", | |
| " \n", | |
| " 1. [Add-on services](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/add-on_services/index)\n", | |
| " 2. [Adding services to a cluster using Red Hat OpenShift Cluster Manager console](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/add-on_services/adding-service)\n", | |
| " 3. [Add-on services available for Red Hat OpenShift Service on AWS](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/add-on_services/rosa-available-services)\n", | |
| " \n", | |
| " 3. Service Mesh\n", | |
| " \n", | |
| " 1. [Service Mesh](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/service_mesh/index)\n", | |
| " 2. [Service Mesh 2.x](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/service_mesh/service-mesh-2-x)\n", | |
| " \n", | |
| " \n", | |
| "10. [Legal notice](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/legal-notice)\n", | |
| "\n", | |
| "Chapter 1. Upgrading ROSA with HCP clusters\n", | |
| "===========================================\n", | |
| "\n", | |
| "* * *\n", | |
| "\n", | |
| "1.1. Upgrade options for ROSA with HCP clusters\n", | |
| "-----------------------------------------------\n", | |
| "\n", | |
| "In OpenShift, upgrading means provisioning a new component with updated software and using it to replace an existing component that has outdated software.\n", | |
| "\n", | |
| "You can control the impact of upgrades to your workload by controlling which parts of the cluster are upgraded, for example:\n", | |
| "\n", | |
| "Upgrade only the hosted control plane\n", | |
| "\n", | |
| "This initiates upgrade of the hosted control plane. It does not impact your worker nodes.\n", | |
| "\n", | |
| "Upgrade nodes in a machine pool\n", | |
| "\n", | |
| "This initiates a rolling replacement of nodes in the specified machine pool, and temporarily impacts the worker nodes on that machine pool. You can also upgrade multiple machine pools concurrently.\n", | |
| "\n", | |
| "Important\n", | |
| "\n", | |
| "You cannot upgrade the hosted control plane at the same time as any machine pool upgrade.\n", | |
| "\n", | |
| "Important\n", | |
| "\n", | |
| "To maintain compatibility between nodes in the cluster, nodes in machine pools cannot use a newer version than the hosted control plane. This means that the hosted control plane should always be upgraded to a given version before any machine pools are upgraded to the same version.\n", | |
| "\n", | |
| "You can further control the time required for a machine pool upgrade, and the impact of an upgrade to your workload, by editing the `--max-surge` and `--max-unavailable` values for each machine pool. These options control the number of nodes that can be upgraded simultaneously on a machine pool, and whether an upgrade provisions excess nodes or makes some existing nodes unavailable or both, for example:\n", | |
| "\n", | |
| "* **To prioritize high workload availability**, you can provision excess nodes instead of making existing nodes unavailable by setting a higher value for `--max-surge` and setting `--max-unavailable` to `0`.\n", | |
| "* **To prioritize lower infrastructure costs**, you can make some existing nodes unavailable and avoid provisioning excess nodes by setting a higher value for `--max-unavailable` and setting `--max-surge` to `0`.\n", | |
| "* **To prioritize upgrade speed by upgrading multiple nodes simultaneously**, you can provision excess nodes and allow some existing nodes to be made unavailable by configuring moderate values for both `--max-surge` and `--max-unavailable`.\n", | |
| "\n", | |
| "For more information about these parameters and their usage, see the _ROSA CLI reference_ for `rosa edit machinepool`.\n", | |
| "\n", | |
| "1.2. Life cycle policies and planning\n", | |
| "-------------------------------------\n", | |
| "\n", | |
| "To plan an upgrade, review the [Red Hat OpenShift Service on AWS update life cycle](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html-single/introduction_to_rosa/#rosa-life-cycle).\n", | |
| "\n", | |
| "The life cycle page includes release definitions, support and upgrade requirements, installation policy information and life cycle dates.\n", | |
| "\n", | |
| "Upgrades are manually initiated or automatically scheduled. Red Hat Site Reliability Engineers (SREs) monitor upgrade progress and remedy any issues encountered.\n", | |
| "\n", | |
| "Note\n", | |
| "\n", | |
| "If your control plane is not currently multi-architecture enabled, the upgrade process will first migrate the cluster to a multi-architecture image and then apply the version upgrade. Multi-architecture clusters are capable of running both x86-based and Arm-based workloads. Clusters created after 25 July, 2024 are multi-architecture enabled by default.\n", | |
| "\n", | |
| "1.3. Upgrading the hosted control plane with the ROSA CLI\n", | |
| "---------------------------------------------------------\n", | |
| "\n", | |
| "You can manually upgrade the hosted control plane of a ROSA with HCP cluster by using the ROSA CLI. This method schedules the control plane for an upgrade if a more recent version is available, either immediately, or at a specified future time.\n", | |
| "\n", | |
| "Note\n", | |
| "\n", | |
| "Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.\n", | |
| "\n", | |
| "**Prerequisites**\n", | |
| "\n", | |
| "* You have installed and configured the latest version of the ROSA CLI.\n", | |
| "* No machine pool upgrades are in progress or scheduled to take place at the same time as the hosted control plane upgrade.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| " \n", | |
| " $ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id\\> 1\n", | |
| " \n", | |
| " [1](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#CO1-1)\n", | |
| " \n", | |
| " Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.\n", | |
| " \n", | |
| "2. List the versions that you can upgrade your control plane to by running the following command:\n", | |
| " \n", | |
| " $ rosa list upgrade --cluster=<cluster\\_name\\_or\\_id\\>\n", | |
| " \n", | |
| " The command returns a list of available updates, including the recommended version.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " VERSION NOTES\n", | |
| " 4.14.8 recommended\n", | |
| " 4.14.7\n", | |
| " 4.14.6\n", | |
| " \n", | |
| "3. Upgrade the cluster’s hosted control plane by running the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id\\> --control-plane \\[--schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\>\\] --version <version\\_number\\>\n", | |
| " \n", | |
| " * To schedule an immediate upgrade to the specified version, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id\\> --control-plane --version <version\\_number\\>\n", | |
| " \n", | |
| " Your hosted control plane is scheduled for an immediate upgrade.\n", | |
| " \n", | |
| " * To schedule an upgrade to the specified version at a future date, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id\\> --control-plane --schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\> --version=<version\\_number\\>\n", | |
| " \n", | |
| " Your hosted control plane is scheduled for an upgrade at the specified time in Coordinated Universal Time (UTC).\n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "**Troubleshooting**\n", | |
| "\n", | |
| "* Sometimes a scheduled upgrade does not initiate. See [Upgrade maintenance canceled](https://access.redhat.com/solutions/6648291) for more information.\n", | |
| "\n", | |
| "1.4. Upgrading machine pools with the ROSA CLI\n", | |
| "----------------------------------------------\n", | |
| "\n", | |
| "You can manually upgrade one or more machine pools in a ROSA with HCP cluster by using the ROSA CLI. This method schedules the specified machine pool for an upgrade if a more recent version is available, either immediately, or at a specified future time.\n", | |
| "\n", | |
| "Note\n", | |
| "\n", | |
| "Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.\n", | |
| "\n", | |
| "**Prerequisites**\n", | |
| "\n", | |
| "* You have installed and configured the latest version of the ROSA CLI.\n", | |
| "* No upgrades for the hosted control plane are in progress on the cluster, or scheduled to occur at the same time as the machine pool upgrade.\n", | |
| "\n", | |
| "Note\n", | |
| "\n", | |
| "Machine pool configurations such as node drain timeout, max-unavailable, and max-surge can affect the timing and success of upgrades.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| " \n", | |
| " $ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id\\> 1\n", | |
| " \n", | |
| " [1](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#CO2-1)\n", | |
| " \n", | |
| " Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " OpenShift Version: 4.14.0\n", | |
| " \n", | |
| "2. List the versions that you can upgrade your machine pools to by running the following command:\n", | |
| " \n", | |
| " $ rosa list upgrade --cluster <cluster-name\\> --machinepool <machinepool\\_name\\>\n", | |
| " \n", | |
| " The command returns a list of available updates, including the recommended version.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " VERSION NOTES\n", | |
| " 4.14.5 recommended\n", | |
| " 4.14.4\n", | |
| " 4.14.3\n", | |
| " \n", | |
| " Important\n", | |
| " \n", | |
| " Do not upgrade your machine pool to a version higher than your control plane. If you want to move to a higher version, upgrade the control plane to that version first.\n", | |
| " \n", | |
| "3. Verify the upgrade behavior of the machine pools you intend to upgrade by running the following command:\n", | |
| " \n", | |
| " $ rosa describe machinepool --cluster=<cluster\\_name\\_or\\_id\\> <machinepool\\_name\\>\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " Replicas: 5\n", | |
| " Node drain grace period: 30 minutes\n", | |
| " \n", | |
| " Management upgrade:\n", | |
| " - Type: Replace\n", | |
| " - Max surge: 20%\n", | |
| " - Max unavailable: 20%\n", | |
| " \n", | |
| " In the example, these settings allow the machine pool to provision one excess node (`max-surge` of 20% of `replicas`) and to have up to one node unavailable (`max-unavailable` of 20% of `replicas`) during an upgrade. This machine pool can therefore upgrade two nodes at a time, by provisioning one new node in excess of the replica count, and by making one node unavailable and replacing it. Node upgrades may be delayed by up to 30 minutes (`node-drain-grace-period` of 30 minutes) if necessary to protect workloads that have a pod disruption budget.\n", | |
| " \n", | |
| "4. Upgrade a machine pool by running the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> \\[--schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\>\\] --version <version\\_number\\>\n", | |
| " \n", | |
| " You can upgrade multiple machine pools concurrently by running this command for each machine pool you want to upgrade.\n", | |
| " \n", | |
| " * To schedule the immediate upgrade of a machine pool, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> --version <version\\_number\\>\n", | |
| " \n", | |
| " The machine pool is scheduled for immediate upgrade, which initiates a rolling replacement of all nodes in the specified machine pool.\n", | |
| " \n", | |
| " * To schedule an upgrade to start at a future time, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> --schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\> --version <version\\_number\\>\n", | |
| " \n", | |
| " The machine pool is scheduled to begin an upgrade at the specified time and date in Coordinated Universal Time (UTC). This will initiate a rolling replacement of all nodes in the specified machine pool, beginning at the specified time.\n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "1.5. Upgrading the whole cluster with the ROSA CLI\n", | |
| "--------------------------------------------------\n", | |
| "\n", | |
| "Upgrading the entire cluster involves upgrading both the hosted control plane and nodes in the machine pools. However, these components cannot be upgraded at the same time. They must be upgraded in sequence. This can be done in any order. However, to maintain compatibility between nodes in the cluster, nodes in machine pools cannot use a newer version than the hosted control plane. Therefore, if both the hosted control plane and the nodes in your machine pools require upgrade to the same OpenShift version, you must upgrade the hosted control plane first, followed by the machine pools.\n", | |
| "\n", | |
| "#### Prerequisites\n", | |
| "\n", | |
| "* You have installed and configured the latest version of the ROSA CLI.\n", | |
| "* No other upgrades are in progress or scheduled to take place at the same time as this upgrade.\n", | |
| "\n", | |
| "### 1.5.1. Upgrading the hosted control plane\n", | |
| "\n", | |
| "When you need to upgrade the whole cluster, upgrade the hosted control plane first.\n", | |
| "\n", | |
| "**Prerequisites**\n", | |
| "\n", | |
| "* You have installed and configured the latest version of the ROSA CLI.\n", | |
| "* No machine pool upgrades are in progress or scheduled to take place at the same time as the hosted control plane upgrade.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| " \n", | |
| " $ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id\\> 1\n", | |
| " \n", | |
| " [1](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#CO3-1)\n", | |
| " \n", | |
| " Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.\n", | |
| " \n", | |
| "2. List the versions that you can upgrade your control plane to by running the following command:\n", | |
| " \n", | |
| " $ rosa list upgrade --cluster=<cluster\\_name\\_or\\_id\\>\n", | |
| " \n", | |
| " The command returns a list of available updates, including the recommended version.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " VERSION NOTES\n", | |
| " 4.14.8 recommended\n", | |
| " 4.14.7\n", | |
| " 4.14.6\n", | |
| " \n", | |
| "3. Upgrade the cluster’s hosted control plane by running the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id\\> --control-plane \\[--schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\>\\] --version <version\\_number\\>\n", | |
| " \n", | |
| " * To schedule an immediate upgrade to the specified version, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id\\> --control-plane --version <version\\_number\\>\n", | |
| " \n", | |
| " Your hosted control plane is scheduled for an immediate upgrade.\n", | |
| " \n", | |
| " * To schedule an upgrade to the specified version at a future date, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id\\> --control-plane --schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\> --version=<version\\_number\\>\n", | |
| " \n", | |
| " Your hosted control plane is scheduled for an upgrade at the specified time in Coordinated Universal Time (UTC).\n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "### 1.5.2. Upgrading machine pools\n", | |
| "\n", | |
| "When your hosted control plane upgrade is complete, you can upgrade one or more machine pools.\n", | |
| "\n", | |
| "Note\n", | |
| "\n", | |
| "Machine pool configurations such as node drain timeout, max-unavailable, and max-surge can affect the timing and success of upgrades.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| " \n", | |
| " $ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id\\> 1\n", | |
| " \n", | |
| " [1](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#CO4-1)\n", | |
| " \n", | |
| " Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " OpenShift Version: 4.14.8\n", | |
| " \n", | |
| "2. List the versions that you can upgrade your machine pools to by running the following command:\n", | |
| " \n", | |
| " $ rosa list upgrade --cluster <cluster-name\\> --machinepool <machinepool\\_name\\>\n", | |
| " \n", | |
| " The command returns a list of available updates, including the recommended version.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " VERSION NOTES\n", | |
| " 4.14.5 recommended\n", | |
| " 4.14.4\n", | |
| " 4.14.3\n", | |
| " \n", | |
| " Important\n", | |
| " \n", | |
| " Do not upgrade your machine pool to a version higher than your control plane. If you want to move to a higher version, upgrade the control plane to that version first.\n", | |
| " \n", | |
| "3. Verify the upgrade behavior of the machine pools you intend to upgrade by running the following command:\n", | |
| " \n", | |
| " $ rosa describe machinepool --cluster=<cluster\\_name\\_or\\_id\\> <machinepool\\_name\\>\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " Replicas: 5\n", | |
| " Node drain grace period: 30 minutes\n", | |
| " \n", | |
| " Management upgrade:\n", | |
| " - Type: Replace\n", | |
| " - Max surge: 20%\n", | |
| " - Max unavailable: 20%\n", | |
| " \n", | |
| " In the example, these settings allow the machine pool to provision one excess node (`max-surge` of 20% of `replicas`) and to have up to one node unavailable (`max-unavailable` of 20% of `replicas`) during an upgrade. This machine pool can therefore upgrade two nodes at a time, by provisioning one new node in excess of the replica count, and by making one node unavailable and replacing it. Node upgrades may be delayed by up to 30 minutes (`node-drain-grace-period` of 30 minutes) if necessary to protect workloads that have a pod disruption budget.\n", | |
| " \n", | |
| "4. Upgrade a machine pool by running the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> \\[--schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\>\\] --version <version\\_number\\>\n", | |
| " \n", | |
| " You can upgrade multiple machine pools concurrently by running this command for each machine pool you want to upgrade.\n", | |
| " \n", | |
| " * To schedule the immediate upgrade of a machine pool, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> --version <version\\_number\\>\n", | |
| " \n", | |
| " The machine pool is scheduled for immediate upgrade, which initiates a rolling replacement of all nodes in the specified machine pool.\n", | |
| " \n", | |
| " * To schedule an upgrade to start at a future time, run the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> --schedule-date=<yyyy-mm-dd\\> --schedule-time=<HH:mm\\> --version <version\\_number\\>\n", | |
| " \n", | |
| " The machine pool is scheduled to begin an upgrade at the specified time and date in Coordinated Universal Time (UTC). This will initiate a rolling replacement of all nodes in the specified machine pool, beginning at the specified time.\n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "1.6. Upgrading with the ROSA CLI\n", | |
| "--------------------------------\n", | |
| "\n", | |
| "You can manually upgrade a ROSA with HCP cluster by using the ROSA CLI. This method schedules the cluster for an immediate upgrade if a more recent version is available.\n", | |
| "\n", | |
| "Note\n", | |
| "\n", | |
| "Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.\n", | |
| "\n", | |
| "**Prerequisites**\n", | |
| "\n", | |
| "* You have installed and configured the latest version of the ROSA CLI.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| " \n", | |
| " $ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id\\> 1\n", | |
| " \n", | |
| " [1](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#CO5-1)\n", | |
| " \n", | |
| " Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.\n", | |
| " \n", | |
| "2. List the versions that you can upgrade your control plane and machine pools to by running the following commands:\n", | |
| " \n", | |
| " 1. For the control plane versions, run the following command:\n", | |
| " \n", | |
| " $ rosa list upgrade --cluster=<cluster\\_name|cluster\\_id\\>\n", | |
| " \n", | |
| " The command returns a list of available updates, including the recommended version.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " VERSION NOTES\n", | |
| " 4.14.8 recommended\n", | |
| " 4.14.7\n", | |
| " 4.14.6\n", | |
| " \n", | |
| " 2. For the machine pool versions, run the following command:\n", | |
| " \n", | |
| " $ rosa list upgrade --cluster <cluster-name\\> --machinepool <machinepool\\_name\\>\n", | |
| " \n", | |
| " The command returns a list of available updates, including the recommended version.\n", | |
| " \n", | |
| " **Example output**\n", | |
| " \n", | |
| " VERSION NOTES\n", | |
| " 4.14.5 recommended\n", | |
| " 4.14.4\n", | |
| " 4.14.3\n", | |
| " \n", | |
| " Note\n", | |
| " \n", | |
| " The latest available update for machine pools is limited to the current current version of the control plane. Ensure your control plane is up to date first.\n", | |
| " \n", | |
| " \n", | |
| "3. Upgrade your cluster with one of the following options:\n", | |
| " \n", | |
| " * Upgrade the cluster’s hosted control plane by running the following command:\n", | |
| " \n", | |
| " $ rosa upgrade cluster -c <cluster\\_name\\> --control-plane \\[--schedule-date=XX --schedule-time=XX\\] \\[--version <version\\_number\\>\\]\n", | |
| " \n", | |
| " Your hosted control plane is now scheduled for an upgrade.\n", | |
| " \n", | |
| " * Upgrade a specific machine pool on your cluster by running the following command:\n", | |
| " \n", | |
| " $ rosa upgrade machinepool -c <cluster\\_name\\> <machinepool\\_name\\> \\[--schedule-date=XX --schedule-time=XX\\] \\[--version <version\\_number\\>\\]\n", | |
| " \n", | |
| " Your machine pool is now scheduled for an upgrade.\n", | |
| " \n", | |
| " \n", | |
| "\n", | |
| "1.7. Upgrading with the OpenShift Cluster Manager console\n", | |
| "---------------------------------------------------------\n", | |
| "\n", | |
| "You can schedule upgrades for a ROSA cluster manually either one time or on a recurring schedule by using OpenShift Cluster Manager console.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Log in to [OpenShift Cluster Manager](https://console.redhat.com/openshift).\n", | |
| "2. Select a cluster to upgrade.\n", | |
| "3. Click the **Settings** tab.\n", | |
| "4. In the **Update strategy** pane, select which type of update you want:\n", | |
| " \n", | |
| " * For individual updates, you can request the upgrade either immediately (to start within an hour) or at a future time.\n", | |
| " * For recurring updates, select a recurring date and time to start the upgrade automatically to the latest x.y.Z (z-stream) version available.\n", | |
| " \n", | |
| " Important\n", | |
| " \n", | |
| " Recurring updates are applicable only for z-stream updates. Minor version or y-stream updates need to be done manually. You will be notified when a new y-stream update is available.\n", | |
| " \n", | |
| " \n", | |
| "5. In the **Update strategy** pane, click **Save** to apply your update strategy.\n", | |
| "6. In the **Update status** pane, review the **Update available** information and click **Update**.\n", | |
| " \n", | |
| " Note\n", | |
| " \n", | |
| " The **Update** button is enabled only when an upgrade is available.\n", | |
| " \n", | |
| "7. The **Update cluster** dialog opens. Recommended cluster upgrades appear in the **Select version** pane. Select the version you want to upgrade your cluster to, and click **Next**.\n", | |
| "8. Optional: For ROSA clusters that use AWS Security Token Service (STS), the account-level and cluster-specific Operator roles might need to be updated, depending on the selected target version.\n", | |
| " \n", | |
| " 1. In the ROSA CLI, run the `rosa list account-roles` command to list and verify that the account roles are compatible with the target minor version chosen for the upgrade. If the roles are not compatible, run the `rosa upgrade account-roles` command to upgrade the account roles to the latest OpenShift version.\n", | |
| " 2. In the ROSA CLI, run the `rosa list operator-roles` command to list and verify that Operator roles associated with the cluster are compatible with the target minor version chosen for the upgrade. If not, run the `rosa upgrade operators-roles` command to upgrade the cluster’s Operator roles to the latest OpenShift version.\n", | |
| " 3. If you select an update version that requires approval, provide an administrator’s acknowledgment by typing **Acknowledge** into the field provided, and click **Next**.\n", | |
| " \n", | |
| "9. In the **Schedule update** dialog, schedule your cluster upgrade.\n", | |
| " \n", | |
| " * To upgrade within an hour, select **Update now** and click **Next**.\n", | |
| " * To upgrade at a later time, select **Schedule a different time** and set a time and date for your upgrade. Click **Next** to proceed to the confirmation dialog.\n", | |
| " \n", | |
| "10. After reviewing the version and schedule summary, select **Confirm update**.\n", | |
| "11. Click **Close** to exit out of the **Update cluster** dialog.\n", | |
| "\n", | |
| "The cluster is scheduled for an upgrade to the target version. This action can take up to an hour, depending on the selected upgrade schedule and your workload configuration, such as pod disruption budgets.\n", | |
| "\n", | |
| "The status is displayed in the **Update status** pane.\n", | |
| "\n", | |
| "**Troubleshooting**\n", | |
| "\n", | |
| "* Sometimes a scheduled upgrade does not trigger. See [Upgrade maintenance cancelled](https://access.redhat.com/solutions/6648291) for more information.\n", | |
| "\n", | |
| "1.8. Deleting an upgrade with the OpenShift Cluster Manager console\n", | |
| "-------------------------------------------------------------------\n", | |
| "\n", | |
| "You can use the OpenShift Cluster Manager console to delete a scheduled upgrade.\n", | |
| "\n", | |
| "**Procedure**\n", | |
| "\n", | |
| "1. Log in to [OpenShift Cluster Manager](https://console.redhat.com/openshift).\n", | |
| "2. Select the cluster with the scheduled upgrade.\n", | |
| "3. Click the **Settings** tab.\n", | |
| "4. In the **Update status** pane, click **Cancel this update**.\n", | |
| "5. Review the update details in the **Cancel update** dialog and click **Cancel this update**.\n", | |
| "\n", | |
| "You will receive an email notification confirming that the scheduled upgrade has been canceled.\n", | |
| "\n", | |
| "[Previous](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/index)[Next](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-upgrading-sts)\n", | |
| "\n", | |
| "Format\n", | |
| "\n", | |
| "Jump to section\n", | |
| "\n", | |
| "* [Upgrade options for ROSA with HCP clusters](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-upgrade-options_rosa-hcp-upgrading)\n", | |
| "* [Life cycle policies and planning](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-lifecycle-policy_rosa-hcp-upgrading)\n", | |
| "* [Upgrading the hosted control plane with the ROSA CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-hcp-upgrading-cli-control-plane_rosa-hcp-upgrading)\n", | |
| "* [Upgrading machine pools with the ROSA CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-hcp-upgrading-cli-machinepool_rosa-hcp-upgrading)\n", | |
| "* [Upgrading the whole cluster with the ROSA CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-hcp-upgrading-cli-cluster_rosa-hcp-upgrading)\n", | |
| "* [Upgrading with the ROSA CLI](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-hcp-upgrading-cli_rosa-hcp-upgrading)\n", | |
| "* [Upgrading with the OpenShift Cluster Manager console](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-upgrade-ocm_rosa-hcp-upgrading)\n", | |
| "* [Deleting an upgrade with the OpenShift Cluster Manager console](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-deleting-cluster-upgrade-ocm_rosa-hcp-upgrading)\n", | |
| "\n", | |
| "Back to top\n", | |
| "\n", | |
| "[](https://docs.redhat.com/en)[Github](https://github.com/redhat-documentation)[Reddit](https://www.reddit.com/r/redhat/)[Youtube](https://www.youtube.com/@redhat)[Twitter](https://twitter.com/RedHat)\n", | |
| "\n", | |
| "### Learn\n", | |
| "\n", | |
| "* [Developer resources](https://developers.redhat.com/learn)\n", | |
| "* [Cloud learning hub](https://cloud.redhat.com/learn)\n", | |
| "* [Interactive labs](https://www.redhat.com/en/interactive-labs)\n", | |
| "* [Training and certification](https://www.redhat.com/services/training-and-certification)\n", | |
| "* [Customer support](https://access.redhat.com/support)\n", | |
| "* [See all documentation](https://docs.redhat.com/products)\n", | |
| "\n", | |
| "### Try, buy, & sell\n", | |
| "\n", | |
| "* [Product trial center](https://redhat.com/en/products/trials)\n", | |
| "* [Red Hat Marketplace](https://marketplace.redhat.com/)\n", | |
| "* [Red Hat Ecosystem Catalog](https://catalog.redhat.com/)\n", | |
| "* [Red Hat Store](https://www.redhat.com/en/store)\n", | |
| "* [Buy online (Japan)](https://www.redhat.com/about/japan-buy)\n", | |
| "\n", | |
| "### Communities\n", | |
| "\n", | |
| "* [Customer Portal Community](https://access.redhat.com/community)\n", | |
| "* [Events](https://www.redhat.com/events)\n", | |
| "* [How we contribute](https://www.redhat.com/about/our-community-contributions)\n", | |
| "\n", | |
| "### About Red Hat Documentation\n", | |
| "\n", | |
| "We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.\n", | |
| "\n", | |
| "### Making open source more inclusive\n", | |
| "\n", | |
| "Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the [Red Hat Blog](https://www.redhat.com/en/blog/making-open-source-more-inclusive-eradicating-problematic-language).\n", | |
| "\n", | |
| "### About Red Hat\n", | |
| "\n", | |
| "We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.\n", | |
| "\n", | |
| "### Red Hat legal and privacy links\n", | |
| "\n", | |
| "* [About Red Hat](https://redhat.com/en/about/company)\n", | |
| "* [Jobs](https://redhat.com/en/jobs)\n", | |
| "* [Events](https://redhat.com/en/events)\n", | |
| "* [Locations](https://redhat.com/en/about/office-locations)\n", | |
| "* [Contact Red Hat](https://redhat.com/en/contact)\n", | |
| "* [Red Hat Blog](https://redhat.com/en/blog)\n", | |
| "* [Diversity, equity, and inclusion](https://redhat.com/en/about/our-culture/diversity-equity-inclusion)\n", | |
| "* [Cool Stuff Store](https://coolstuff.redhat.com/)\n", | |
| "* [Red Hat Summit](https://www.redhat.com/en/summit)\n", | |
| "\n", | |
| "© 2024 Red Hat, Inc.\n", | |
| "\n", | |
| "### Red Hat legal and privacy links\n", | |
| "\n", | |
| "* [Privacy statement](https://redhat.com/en/about/privacy-policy)\n", | |
| "* [Terms of use](https://redhat.com/en/about/terms-use)\n", | |
| "* [All policies and guidelines](https://redhat.com/en/about/all-policies-guidelines)\n", | |
| "* [Digital accessibility](https://redhat.com/en/about/digital-accessibility)\n", | |
| "\n" | |
| ] | |
| } | |
| ] | |
| }, | |
| { | |
| "cell_type": "markdown", | |
| "source": [ | |
| "## Docling" | |
| ], | |
| "metadata": { | |
| "id": "R8NUDb6KeP6X" | |
| } | |
| }, | |
| { | |
| "cell_type": "code", | |
| "source": [ | |
| "%pip install docling -qqq" | |
| ], | |
| "metadata": { | |
| "colab": { | |
| "base_uri": "https://localhost:8080/" | |
| }, | |
| "id": "vuhmr7BefL3b", | |
| "outputId": "febdcfc5-d50c-433d-af38-e2f11484da29" | |
| }, | |
| "execution_count": 4, | |
| "outputs": [ | |
| { | |
| "output_type": "stream", | |
| "name": "stdout", | |
| "text": [ | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m48.2/48.2 kB\u001b[0m \u001b[31m2.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m113.3/113.3 kB\u001b[0m \u001b[31m7.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m7.8/7.8 MB\u001b[0m \u001b[31m58.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m91.4/91.4 kB\u001b[0m \u001b[31m5.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m66.0/66.0 kB\u001b[0m \u001b[31m4.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m22.4/22.4 MB\u001b[0m \u001b[31m50.9 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m2.9/2.9 MB\u001b[0m \u001b[31m60.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m42.1/42.1 kB\u001b[0m \u001b[31m3.0 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m2.9/2.9 MB\u001b[0m \u001b[31m52.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m244.3/244.3 kB\u001b[0m \u001b[31m14.7 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m472.8/472.8 kB\u001b[0m \u001b[31m24.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m543.2/543.2 kB\u001b[0m \u001b[31m27.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m47.3/47.3 kB\u001b[0m \u001b[31m3.2 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m4.5/4.5 MB\u001b[0m \u001b[31m64.5 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m159.9/159.9 kB\u001b[0m \u001b[31m9.4 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m422.9/422.9 kB\u001b[0m \u001b[31m25.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m969.6/969.6 kB\u001b[0m \u001b[31m39.6 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m286.6/286.6 kB\u001b[0m \u001b[31m16.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m62.7/62.7 kB\u001b[0m \u001b[31m3.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m144.3/144.3 kB\u001b[0m \u001b[31m11.1 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m272.8/272.8 kB\u001b[0m \u001b[31m17.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[2K \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m119.4/119.4 kB\u001b[0m \u001b[31m8.8 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\n", | |
| "\u001b[?25h" | |
| ] | |
| } | |
| ] | |
| }, | |
| { | |
| "cell_type": "markdown", | |
| "source": [ | |
| "```\n", | |
| "from docling.document_converter import DocumentConverter\n", | |
| "\n", | |
| "source = \"https://arxiv.org/pdf/2408.09869\" # document per local path or URL\n", | |
| "converter = DocumentConverter()\n", | |
| "result = converter.convert(source)\n", | |
| "print(result.document.export_to_markdown()) # output: \"## Docling Technical Report[...]\"\n", | |
| "```" | |
| ], | |
| "metadata": { | |
| "id": "8VR1bGnFfdby" | |
| } | |
| }, | |
| { | |
| "cell_type": "code", | |
| "source": [ | |
| "# prompt: Get started with docling using the openshift rosa url\n", | |
| "\n", | |
| "from httpx import get as getx\n", | |
| "from docling.document_converter import DocumentConverter\n", | |
| "\n", | |
| "# ## Docling - using the openshift rosa URL\n", | |
| "source = \"https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/upgrading/rosa-hcp-upgrading#rosa-lifecycle-policy_rosa-hcp-upgrading\"\n", | |
| "converter = DocumentConverter()\n", | |
| "\n", | |
| "try:\n", | |
| " result = converter.convert(source)\n", | |
| " print(result.document.export_to_markdown())\n", | |
| "except Exception as e:\n", | |
| " print(f\"An error occurred: {e}\")" | |
| ], | |
| "metadata": { | |
| "colab": { | |
| "base_uri": "https://localhost:8080/" | |
| }, | |
| "id": "yefswwE6fOR-", | |
| "outputId": "ab42e6a7-3f82-4d54-94ec-645b60ec25b5" | |
| }, | |
| "execution_count": 6, | |
| "outputs": [ | |
| { | |
| "output_type": "stream", | |
| "name": "stdout", | |
| "text": [ | |
| "Featured links\n", | |
| "\n", | |
| "- Support\n", | |
| "- Console\n", | |
| "- Developers\n", | |
| "- Start a trial\n", | |
| "- All Red Hat\n", | |
| " - For customers\n", | |
| " - Customer support\n", | |
| " - Documentation\n", | |
| " - Support Cases\n", | |
| " - Subscription management\n", | |
| " - Red Hat Ecosystem Catalog\n", | |
| " - Find a partner\n", | |
| "- For partners\n", | |
| " - Partner login\n", | |
| " - Partner support\n", | |
| " - Become a partner\n", | |
| "- Try, buy, & sell\n", | |
| "\n", | |
| "- Red Hat Marketplace\n", | |
| "- Red Hat Store\n", | |
| "- Contact Sales\n", | |
| "- Start a trial\n", | |
| "- Learning resources\n", | |
| "\n", | |
| "- Training and certification\n", | |
| "- For developers\n", | |
| "- Hybrid cloud learning hub\n", | |
| "- Interactive labs\n", | |
| "- Learning community\n", | |
| "- Red Hat TV\n", | |
| "- Open source communities\n", | |
| "\n", | |
| "- Ansible\n", | |
| "- For system administrators\n", | |
| "- For architects\n", | |
| "\n", | |
| "<!-- image -->\n", | |
| "\n", | |
| "<!-- image -->\n", | |
| "\n", | |
| "1. Home\n", | |
| "2. Products\n", | |
| "3. Red Hat OpenShift Service on AWS\n", | |
| "4. 4\n", | |
| "5. Upgrading\n", | |
| "6. Chapter 1. Upgrading ROSA with HCP clusters\n", | |
| "\n", | |
| "# Red Hat OpenShift Service on AWS\n", | |
| "\n", | |
| "# Red Hat OpenShift Service on AWS\n", | |
| "\n", | |
| "1 Get started\n", | |
| " 1 About\n", | |
| " 1. About\n", | |
| " 2. Red Hat OpenShift Service on AWS 4 Documentation\n", | |
| " 3. Learn more about ROSA with HCP\n", | |
| " 4. AWS STS and ROSA with HCP explained\n", | |
| "2 What’s new\n", | |
| " 1. What’s new\n", | |
| " 2. What’s new with Red Hat OpenShift Service on AWS\n", | |
| "3 Getting started\n", | |
| "\n", | |
| "1. Getting started\n", | |
| "2. Red Hat OpenShift Service on AWS quick start guide\n", | |
| "3. Comprehensive guide to getting started with Red Hat OpenShift Service on AWS\n", | |
| "4. Understanding the ROSA with STS deployment workflow\n", | |
| "4 Introduction to ROSA\n", | |
| "\n", | |
| "1. Introduction to ROSA\n", | |
| "2. Understanding ROSA\n", | |
| "3. Policies and service definition\n", | |
| "4. About IAM resources for ROSA clusters that use STS\n", | |
| "5. OpenID Connect Overview\n", | |
| "5 Architecture\n", | |
| "\n", | |
| "1. Architecture\n", | |
| "2. Architecture overview\n", | |
| "3. Red Hat OpenShift Service on AWS architecture\n", | |
| "4. Architecture models\n", | |
| "5. Control plane architecture\n", | |
| "6. NVIDIA GPU architecture overview\n", | |
| "7. Understanding Red Hat OpenShift Service on AWS development\n", | |
| "8. Admission plugins\n", | |
| "6 Tutorials\n", | |
| "\n", | |
| "1. Tutorials\n", | |
| "2. Tutorials overview\n", | |
| "3. Tutorial: ROSA with HCP activation and account linking\n", | |
| "4. Tutorial: ROSA with HCP private offer acceptance and sharing\n", | |
| "5. Tutorial: Verifying Permissions for a ROSA STS Deployment\n", | |
| "6. Tutorial: Deploying ROSA with a Custom DNS Resolver\n", | |
| "7. Tutorial: Using AWS WAF and Amazon CloudFront to protect ROSA workloads\n", | |
| "8. Tutorial: Using AWS WAF and AWS ALBs to protect ROSA workloads\n", | |
| "9. Tutorial: Deploying OpenShift API for Data Protection on a ROSA cluster\n", | |
| "10. Tutorial: AWS Load Balancer Operator on ROSA\n", | |
| "11. Tutorial: Configuring Microsoft Entra ID (formerly Azure Active Directory) as an identity provider\n", | |
| "12. Tutorial: Using AWS Secrets Manager CSI on ROSA with STS\n", | |
| "13. Tutorial: Using AWS Controllers for Kubernetes on ROSA\n", | |
| "14. Tutorial: Deploying the External DNS Operator on ROSA\n", | |
| "15. Tutorial: Dynamically issuing certificates using the cert-manager Operator on ROSA\n", | |
| "16. Tutorial: Assigning a consistent egress IP for external traffic\n", | |
| "17. Tutorial: Updating component routes with custom domains and TLS certificates\n", | |
| "18. Getting started with ROSA\n", | |
| "19. Deploying an application\n", | |
| "7 Prepare your environment\n", | |
| "\n", | |
| "1. Prepare your environment\n", | |
| "2. Prerequisites checklist for deploying ROSA using STS\n", | |
| "3. Detailed requirements for deploying ROSA using STS\n", | |
| "4. ROSA IAM role resources\n", | |
| "5. Limits and scalability\n", | |
| "6. ROSA with HCP limits and scalability\n", | |
| "7. Planning your environment\n", | |
| "8. Required AWS service quotas\n", | |
| "9. Setting up the environment for using STS\n", | |
| "2 Create clusters\n", | |
| "\n", | |
| "1 Install ROSA Classic clusters\n", | |
| " 1. Install ROSA Classic clusters\n", | |
| " 2. Creating a ROSA cluster with STS using the default options\n", | |
| " 3. Creating a ROSA cluster with STS using customizations\n", | |
| " 4. Creating a ROSA (classic architecture) cluster using Terraform\n", | |
| " 5. Interactive cluster creation mode reference\n", | |
| " 6. Creating an AWS PrivateLink cluster on ROSA\n", | |
| " 7. Configuring a shared VPC for ROSA clusters\n", | |
| " 8. Accessing a ROSA cluster\n", | |
| " 9. Configuring identity providers for STS\n", | |
| " 10. Revoking access to a ROSA cluster\n", | |
| " 11. Deleting a ROSA cluster\n", | |
| " 12. Deploying ROSA without AWS STS\n", | |
| "2 Install ROSA with HCP clusters\n", | |
| "\n", | |
| "1. Install ROSA with HCP clusters\n", | |
| "2. Creating ROSA with HCP clusters using the default options\n", | |
| "3. Creating a ROSA cluster using Terraform\n", | |
| "4. Creating ROSA with HCP clusters using a custom AWS KMS encryption key\n", | |
| "5. Creating a private cluster on ROSA with HCP\n", | |
| "6. Creating ROSA with HCP clusters with external authentication\n", | |
| "7. ROSA with HCP clusters without a CNI plugin\n", | |
| "8. Deleting a ROSA with HCP cluster\n", | |
| "3 Support\n", | |
| "\n", | |
| "1. Support\n", | |
| "2. Support overview\n", | |
| "3. Managing your cluster resources\n", | |
| "4. Approved Access\n", | |
| "5. Getting support\n", | |
| "6. Remote health monitoring with connected clusters\n", | |
| "7. Gathering data about your cluster\n", | |
| "8. Summarizing cluster specifications\n", | |
| "9. Troubleshooting\n", | |
| "4 Web console\n", | |
| "\n", | |
| "1. Web console\n", | |
| "2. Web Console Overview\n", | |
| "3. Accessing the web console\n", | |
| "4. Using the Red Hat OpenShift Service on AWS dashboard to get cluster information\n", | |
| "5. Dynamic plugins\n", | |
| "6. Web terminal\n", | |
| "7. About quick start tutorials\n", | |
| "3 Update clusters\n", | |
| "\n", | |
| "1 Upgrading\n", | |
| " 1. Upgrading\n", | |
| " 2. Upgrading ROSA with HCP clusters\n", | |
| " 3. Upgrading ROSA (classic architecture) clusters\n", | |
| "2 Logging\n", | |
| "\n", | |
| "1. Logging\n", | |
| "2. Release notes\n", | |
| "3. Support\n", | |
| "4. Troubleshooting logging\n", | |
| "5. About Logging\n", | |
| "6. Installing Logging\n", | |
| "7. Updating Logging\n", | |
| "8. Visualizing logs\n", | |
| "9. Configuring your Logging deployment\n", | |
| "10. Log collection and forwarding\n", | |
| "11. Log storage\n", | |
| "12. Logging alerts\n", | |
| "13. Performance and reliability tuning\n", | |
| "14. Scheduling resources\n", | |
| "15. Uninstalling Logging\n", | |
| "16. Log Record Fields\n", | |
| "17. tags\n", | |
| "18. kubernetes\n", | |
| "19. OpenShift\n", | |
| "20. API reference\n", | |
| "21. Glossary\n", | |
| "4 Manage clusters\n", | |
| "\n", | |
| "1 Cluster administration\n", | |
| " 1. Cluster administration\n", | |
| " 2. Cluster notifications\n", | |
| " 3. Configuring private connections\n", | |
| " 4. Cluster autoscaling\n", | |
| " 5. Manage nodes using machine pools\n", | |
| " 6. Configuring PID limits\n", | |
| "2 Red Hat OpenShift Cluster Manager\n", | |
| "\n", | |
| "1. Red Hat OpenShift Cluster Manager\n", | |
| "2. Red Hat OpenShift Cluster Manager\n", | |
| "3 CLI tools\n", | |
| "\n", | |
| "1. CLI tools\n", | |
| "2. Red Hat OpenShift Service on AWS CLI tools overview\n", | |
| "3. OpenShift CLI (oc)\n", | |
| "4. Important update on odo\n", | |
| "5. Knative CLI for use with OpenShift Serverless\n", | |
| "6. Pipelines CLI (tkn)\n", | |
| "7. opm CLI\n", | |
| "8. Operator SDK\n", | |
| "9. ROSA CLI\n", | |
| "4 Storage\n", | |
| "\n", | |
| "1. Storage\n", | |
| "2. Red Hat OpenShift Service on AWS storage overview\n", | |
| "3. Understanding ephemeral storage\n", | |
| "4. Understanding persistent storage\n", | |
| "5. Configuring persistent storage\n", | |
| "6. Using Container Storage Interface (CSI)\n", | |
| "7. Generic ephemeral volumes\n", | |
| "8. Dynamic provisioning\n", | |
| "5 Networking\n", | |
| "\n", | |
| "1. Networking\n", | |
| "2. About networking\n", | |
| "3. Networking Operators\n", | |
| "4. Network verification for ROSA clusters\n", | |
| "5. Configuring a cluster-wide proxy\n", | |
| "6. CIDR range definitions\n", | |
| "7. Network security\n", | |
| "8. OVN-Kubernetes network plugin\n", | |
| "9. OpenShift SDN network plugin\n", | |
| "10. Configuring Routes\n", | |
| "6 Operators\n", | |
| "\n", | |
| "1. Operators\n", | |
| "2. Operators overview\n", | |
| "3. Understanding Operators\n", | |
| "4. User tasks\n", | |
| "5. Administrator tasks\n", | |
| "6. Developing Operators\n", | |
| "7 Nodes\n", | |
| "\n", | |
| "1. Nodes\n", | |
| "2. Overview of nodes\n", | |
| "3. Working with pods\n", | |
| "4. Automatically scaling pods with the Custom Metrics Autoscaler Operator\n", | |
| "5. Controlling pod placement onto nodes (scheduling)\n", | |
| "6. Using jobs and daemon sets\n", | |
| "7. Working with nodes\n", | |
| "8. Working with containers\n", | |
| "9. Working with clusters\n", | |
| "8 Backup and restore\n", | |
| "\n", | |
| "1. Backup and restore\n", | |
| "2. OADP Application backup and restore\n", | |
| "5 Alerts and monitoring\n", | |
| "\n", | |
| "1 Monitoring\n", | |
| " 1. Monitoring\n", | |
| " 2. Monitoring overview\n", | |
| " 3. Accessing monitoring for user-defined projects\n", | |
| " 4. Configuring the monitoring stack\n", | |
| " 5. Configuring external Alertmanager instances\n", | |
| " 6. Configuring secrets for Alertmanager\n", | |
| " 7. Using pod topology spread constraints for monitoring\n", | |
| " 8. Disabling monitoring for user-defined projects\n", | |
| " 9. Enabling alert routing for user-defined projects\n", | |
| " 10. Managing metrics\n", | |
| " 11. Managing alerts\n", | |
| " 12. Reviewing monitoring dashboards\n", | |
| " 13. Accessing monitoring APIs by using the CLI\n", | |
| " 14. Troubleshooting monitoring issues\n", | |
| " 15. Config map reference for the Cluster Monitoring Operator\n", | |
| "6 Security and compliance\n", | |
| "\n", | |
| "1 Authentication and authorization\n", | |
| " 1. Authentication and authorization\n", | |
| " 2. Overview of authentication and authorization\n", | |
| " 3. Understanding authentication\n", | |
| " 4. Managing user-owned OAuth access tokens\n", | |
| " 5. Configuring identity providers\n", | |
| " 6. Using RBAC to define and apply permissions\n", | |
| " 7. Understanding and creating service accounts\n", | |
| " 8. Using service accounts in applications\n", | |
| " 9. Using a service account as an OAuth client\n", | |
| " 10. Assuming an AWS IAM role for a service account\n", | |
| " 11. Scoping tokens\n", | |
| " 12. Using bound service account tokens\n", | |
| " 13. Managing security context constraints\n", | |
| " 14. Understanding and managing pod security admission\n", | |
| " 15. Syncing LDAP groups\n", | |
| "2 Security and compliance\n", | |
| "\n", | |
| "1. Security and compliance\n", | |
| "2. Viewing audit logs\n", | |
| "3. Adding additional constraints for IP-based AWS role assumption\n", | |
| "7 Develop and deploy applications\n", | |
| "\n", | |
| "1 Images\n", | |
| " 1. Images\n", | |
| " 2. Overview of images\n", | |
| " 3. Overview of the Cluster Samples Operator\n", | |
| " 4. Using the Cluster Samples Operator with an alternate registry\n", | |
| " 5. Creating images\n", | |
| " 6. Managing images\n", | |
| " 7. Managing image streams\n", | |
| " 8. Using image streams with Kubernetes resources\n", | |
| " 9. Triggering updates on image stream changes\n", | |
| " 10. Image configuration resources (Classic)\n", | |
| " 11. Image configuration resources for ROSA with HCP\n", | |
| " 12. Using templates\n", | |
| " 13. Using Ruby on Rails\n", | |
| "2 Building applications\n", | |
| "\n", | |
| "1. Building applications\n", | |
| "2. Building applications overview\n", | |
| "3. Projects\n", | |
| "4. Creating applications\n", | |
| "5. Viewing application composition by using the Topology view\n", | |
| "6. Working with Helm charts\n", | |
| "7. Deployments\n", | |
| "8. Quotas\n", | |
| "9. Using config maps with applications\n", | |
| "10. Monitoring project and application metrics using the Developer perspective\n", | |
| "11. Monitoring application health by using health checks\n", | |
| "12. Editing applications\n", | |
| "13. Working with quotas\n", | |
| "14. Pruning objects to reclaim resources\n", | |
| "15. Idling applications\n", | |
| "16. Deleting applications\n", | |
| "17. Using the Red Hat Marketplace\n", | |
| "3 Application development\n", | |
| "\n", | |
| "1. Application development\n", | |
| "2. Deployments\n", | |
| "4 Registry\n", | |
| "\n", | |
| "1. Registry\n", | |
| "2. OpenShift image registry overview\n", | |
| "3. Image Registry Operator in Red Hat OpenShift Service on AWS\n", | |
| "4. Accessing the registry\n", | |
| "8 CI/CD\n", | |
| "\n", | |
| "1 CI/CD overview\n", | |
| " 1. CI/CD overview\n", | |
| " 2. About CI/CD\n", | |
| "2 Builds using Shipwright\n", | |
| "\n", | |
| "1. Builds using Shipwright\n", | |
| "2. Overview of Builds\n", | |
| "3 Builds using BuildConfig\n", | |
| "\n", | |
| "1. Builds using BuildConfig\n", | |
| "2. Understanding image builds\n", | |
| "3. Understanding build configurations\n", | |
| "4. Creating build inputs\n", | |
| "5. Managing build output\n", | |
| "6. Using build strategies\n", | |
| "7. Performing and configuring basic builds\n", | |
| "8. Triggering and modifying builds\n", | |
| "9. Performing advanced builds\n", | |
| "10. Using Red Hat subscriptions in builds\n", | |
| "11. Troubleshooting builds\n", | |
| "4 GitOps\n", | |
| "\n", | |
| "1. GitOps\n", | |
| "2. About Red Hat OpenShift GitOps\n", | |
| "5 Pipelines\n", | |
| "\n", | |
| "1. Pipelines\n", | |
| "2. About Red Hat OpenShift Pipelines\n", | |
| "6 Jenkins\n", | |
| "\n", | |
| "1. Jenkins\n", | |
| "2. Configuring Jenkins images\n", | |
| "3. Jenkins agent\n", | |
| "4. Migrating from Jenkins to OpenShift Pipelines or Tekton\n", | |
| "5. Important changes to OpenShift Jenkins images\n", | |
| "9 Integrate with other products and services\n", | |
| "\n", | |
| "1 Virtualization\n", | |
| " 1. Virtualization\n", | |
| " 2. About\n", | |
| " 3. Getting started\n", | |
| " 4. Installing\n", | |
| " 5. Post-installation configuration\n", | |
| " 6. Updating\n", | |
| " 7. Virtual machines\n", | |
| " 8. Networking\n", | |
| " 9. Storage\n", | |
| " 10. Live migration\n", | |
| " 11. Nodes\n", | |
| " 12. Monitoring\n", | |
| " 13. Support\n", | |
| " 14. Backup and restore\n", | |
| "2 Add-on services\n", | |
| "\n", | |
| "1. Add-on services\n", | |
| "2. Adding services to a cluster using Red Hat OpenShift Cluster Manager console\n", | |
| "3. Add-on services available for Red Hat OpenShift Service on AWS\n", | |
| "3 Service Mesh\n", | |
| "\n", | |
| "1. Service Mesh\n", | |
| "2. Service Mesh 2.x\n", | |
| "10. Legal notice\n", | |
| "\n", | |
| "# Chapter 1. Upgrading ROSA with HCP clusters\n", | |
| "\n", | |
| "## 1.1. Upgrade options for ROSA with HCP clusters\n", | |
| "\n", | |
| "In OpenShift, upgrading means provisioning a new component with updated software and using it to replace an existing component that has outdated software.\n", | |
| "\n", | |
| "You can control the impact of upgrades to your workload by controlling which parts of the cluster are upgraded, for example:\n", | |
| "\n", | |
| "You cannot upgrade the hosted control plane at the same time as any machine pool upgrade.\n", | |
| "\n", | |
| "To maintain compatibility between nodes in the cluster, nodes in machine pools cannot use a newer version than the hosted control plane. This means that the hosted control plane should always be upgraded to a given version before any machine pools are upgraded to the same version.\n", | |
| "\n", | |
| "You can further control the time required for a machine pool upgrade, and the impact of an upgrade to your workload, by editing the --max-surge and --max-unavailable values for each machine pool. These options control the number of nodes that can be upgraded simultaneously on a machine pool, and whether an upgrade provisions excess nodes or makes some existing nodes unavailable or both, for example:\n", | |
| "\n", | |
| "- To prioritize high workload availability, you can provision excess nodes instead of making existing nodes unavailable by setting a higher value for --max-surge and setting --max-unavailable to 0.\n", | |
| "- To prioritize lower infrastructure costs, you can make some existing nodes unavailable and avoid provisioning excess nodes by setting a higher value for --max-unavailable and setting --max-surge to 0.\n", | |
| "- To prioritize upgrade speed by upgrading multiple nodes simultaneously, you can provision excess nodes and allow some existing nodes to be made unavailable by configuring moderate values for both --max-surge and --max-unavailable.\n", | |
| "\n", | |
| "For more information about these parameters and their usage, see the ROSA CLI reference for rosa edit machinepool.\n", | |
| "\n", | |
| "## 1.2. Life cycle policies and planning\n", | |
| "\n", | |
| "To plan an upgrade, review the Red Hat OpenShift Service on AWS update life cycle.\n", | |
| "\n", | |
| "The life cycle page includes release definitions, support and upgrade requirements, installation policy information and life cycle dates.\n", | |
| "\n", | |
| "Upgrades are manually initiated or automatically scheduled. Red Hat Site Reliability Engineers (SREs) monitor upgrade progress and remedy any issues encountered.\n", | |
| "\n", | |
| "If your control plane is not currently multi-architecture enabled, the upgrade process will first migrate the cluster to a multi-architecture image and then apply the version upgrade. Multi-architecture clusters are capable of running both x86-based and Arm-based workloads. Clusters created after 25 July, 2024 are multi-architecture enabled by default.\n", | |
| "\n", | |
| "## 1.3. Upgrading the hosted control plane with the ROSA CLI\n", | |
| "\n", | |
| "You can manually upgrade the hosted control plane of a ROSA with HCP cluster by using the ROSA CLI. This method schedules the control plane for an upgrade if a more recent version is available, either immediately, or at a specified future time.\n", | |
| "\n", | |
| "Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.\n", | |
| "\n", | |
| "Prerequisites\n", | |
| "\n", | |
| "- You have installed and configured the latest version of the ROSA CLI.\n", | |
| "- No machine pool upgrades are in progress or scheduled to take place at the same time as the hosted control plane upgrade.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| "\t\t\t\t\t$ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id> 11 \n", | |
| "\t\t\t\t\t\t\t\tReplace <cluster\\_name\\_or\\_id> with the cluster name or the cluster ID.\n", | |
| "2. List the versions that you can upgrade your control plane to by running the following command:\n", | |
| "\t\t\t\t\t$ rosa list upgrade --cluster=<cluster\\_name\\_or\\_id>\n", | |
| "\t\t\t\t\t\tThe command returns a list of available updates, including the recommended version.\n", | |
| "\t\t\t\t\tExample output\n", | |
| "VERSION NOTES\n", | |
| "4.14.8 recommended\n", | |
| "4.14.7\n", | |
| "4.14.6\n", | |
| "3 Upgrade the cluster’s hosted control plane by running the following command: $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number>\n", | |
| "\n", | |
| "Upgrade the cluster’s hosted control plane by running the following command:\n", | |
| "\n", | |
| "```\n", | |
| "$ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number>\n", | |
| "```\n", | |
| "\n", | |
| " - To schedule an immediate upgrade to the specified version, run the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane --version <version\\_number>\n", | |
| "\t\t\t\t\t\t\t\tYour hosted control plane is scheduled for an immediate upgrade.\n", | |
| " - To schedule an upgrade to the specified version at a future date, run the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version\\_number>\n", | |
| "\t\t\t\t\t\t\t\tYour hosted control plane is scheduled for an upgrade at the specified time in Coordinated Universal Time (UTC).\n", | |
| "\n", | |
| "Troubleshooting\n", | |
| "\n", | |
| "- Sometimes a scheduled upgrade does not initiate. See Upgrade maintenance canceled for more information.\n", | |
| "\n", | |
| "## 1.4. Upgrading machine pools with the ROSA CLI\n", | |
| "\n", | |
| "You can manually upgrade one or more machine pools in a ROSA with HCP cluster by using the ROSA CLI. This method schedules the specified machine pool for an upgrade if a more recent version is available, either immediately, or at a specified future time.\n", | |
| "\n", | |
| "Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.\n", | |
| "\n", | |
| "Prerequisites\n", | |
| "\n", | |
| "- You have installed and configured the latest version of the ROSA CLI.\n", | |
| "- No upgrades for the hosted control plane are in progress on the cluster, or scheduled to occur at the same time as the machine pool upgrade.\n", | |
| "\n", | |
| "Machine pool configurations such as node drain timeout, max-unavailable, and max-surge can affect the timing and success of upgrades.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| "\t\t\t\t\t$ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id> 11 \n", | |
| "\t\t\t\t\t\t\t\tReplace <cluster\\_name\\_or\\_id> with the cluster name or the cluster ID.\n", | |
| "\t\t\t\t\t\t\tExample output\n", | |
| "OpenShift Version: 4.14.0\n", | |
| "2. List the versions that you can upgrade your machine pools to by running the following command:\n", | |
| "\t\t\t\t\t$ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool\\_name>\n", | |
| "\t\t\t\t\t\tThe command returns a list of available updates, including the recommended version.\n", | |
| "\t\t\t\t\tExample output\n", | |
| "VERSION NOTES\n", | |
| "4.14.5 recommended\n", | |
| "4.14.4\n", | |
| "4.14.3\n", | |
| "Important\n", | |
| "\t\t\t\t\t\t\tDo not upgrade your machine pool to a version higher than your control plane. If you want to move to a higher version, upgrade the control plane to that version first.\n", | |
| "3. Verify the upgrade behavior of the machine pools you intend to upgrade by running the following command:\n", | |
| "\t\t\t\t\t$ rosa describe machinepool --cluster=<cluster\\_name\\_or\\_id> <machinepool\\_name>Example output\n", | |
| "Replicas: 5\n", | |
| "Node drain grace period: 30 minutes\n", | |
| "\n", | |
| "Management upgrade:\n", | |
| "- Type: Replace\n", | |
| "- Max surge: 20%\n", | |
| "- Max unavailable: 20%\n", | |
| "\n", | |
| "\t\t\t\t\t\tIn the example, these settings allow the machine pool to provision one excess node (max-surge of 20% of replicas) and to have up to one node unavailable (max-unavailable of 20% of replicas) during an upgrade. This machine pool can therefore upgrade two nodes at a time, by provisioning one new node in excess of the replica count, and by making one node unavailable and replacing it. Node upgrades may be delayed by up to 30 minutes (node-drain-grace-period of 30 minutes) if necessary to protect workloads that have a pod disruption budget.\n", | |
| "4 Upgrade a machine pool by running the following command: $ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number> You can upgrade multiple machine pools concurrently by running this command for each machine pool you want to upgrade.\n", | |
| "\n", | |
| "Upgrade a machine pool by running the following command:\n", | |
| "\n", | |
| "```\n", | |
| "$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number>\n", | |
| "```\n", | |
| "\n", | |
| "You can upgrade multiple machine pools concurrently by running this command for each machine pool you want to upgrade.\n", | |
| "\n", | |
| " - To schedule the immediate upgrade of a machine pool, run the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> --version <version\\_number>\n", | |
| "\t\t\t\t\t\t\t\tThe machine pool is scheduled for immediate upgrade, which initiates a rolling replacement of all nodes in the specified machine pool.\n", | |
| " - To schedule an upgrade to start at a future time, run the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version\\_number>\n", | |
| "\t\t\t\t\t\t\t\tThe machine pool is scheduled to begin an upgrade at the specified time and date in Coordinated Universal Time (UTC). This will initiate a rolling replacement of all nodes in the specified machine pool, beginning at the specified time.\n", | |
| "\n", | |
| "## 1.5. Upgrading the whole cluster with the ROSA CLI\n", | |
| "\n", | |
| "Upgrading the entire cluster involves upgrading both the hosted control plane and nodes in the machine pools. However, these components cannot be upgraded at the same time. They must be upgraded in sequence. This can be done in any order. However, to maintain compatibility between nodes in the cluster, nodes in machine pools cannot use a newer version than the hosted control plane. Therefore, if both the hosted control plane and the nodes in your machine pools require upgrade to the same OpenShift version, you must upgrade the hosted control plane first, followed by the machine pools.\n", | |
| "\n", | |
| "#### Prerequisites\n", | |
| "\n", | |
| "- You have installed and configured the latest version of the ROSA CLI.\n", | |
| "- No other upgrades are in progress or scheduled to take place at the same time as this upgrade.\n", | |
| "\n", | |
| "### 1.5.1. Upgrading the hosted control plane\n", | |
| "\n", | |
| "When you need to upgrade the whole cluster, upgrade the hosted control plane first.\n", | |
| "\n", | |
| "Prerequisites\n", | |
| "\n", | |
| "- You have installed and configured the latest version of the ROSA CLI.\n", | |
| "- No machine pool upgrades are in progress or scheduled to take place at the same time as the hosted control plane upgrade.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| "\t\t\t\t\t\t$ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id> 11 \n", | |
| "\t\t\t\t\t\t\t\t\tReplace <cluster\\_name\\_or\\_id> with the cluster name or the cluster ID.\n", | |
| "2. List the versions that you can upgrade your control plane to by running the following command:\n", | |
| "\t\t\t\t\t\t$ rosa list upgrade --cluster=<cluster\\_name\\_or\\_id>\n", | |
| "\t\t\t\t\t\t\tThe command returns a list of available updates, including the recommended version.\n", | |
| "\t\t\t\t\t\tExample output\n", | |
| "VERSION NOTES\n", | |
| "4.14.8 recommended\n", | |
| "4.14.7\n", | |
| "4.14.6\n", | |
| "3 Upgrade the cluster’s hosted control plane by running the following command: $ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number>\n", | |
| "\n", | |
| "Upgrade the cluster’s hosted control plane by running the following command:\n", | |
| "\n", | |
| "```\n", | |
| "$ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number>\n", | |
| "```\n", | |
| "\n", | |
| " - To schedule an immediate upgrade to the specified version, run the following command:\n", | |
| "\t\t\t\t\t\t\t\t$ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane --version <version\\_number>\n", | |
| "\t\t\t\t\t\t\t\t\tYour hosted control plane is scheduled for an immediate upgrade.\n", | |
| " - To schedule an upgrade to the specified version at a future date, run the following command:\n", | |
| "\t\t\t\t\t\t\t\t$ rosa upgrade cluster -c <cluster\\_name\\_or\\_id> --control-plane --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version\\_number>\n", | |
| "\t\t\t\t\t\t\t\t\tYour hosted control plane is scheduled for an upgrade at the specified time in Coordinated Universal Time (UTC).\n", | |
| "\n", | |
| "### 1.5.2. Upgrading machine pools\n", | |
| "\n", | |
| "When your hosted control plane upgrade is complete, you can upgrade one or more machine pools.\n", | |
| "\n", | |
| "Machine pool configurations such as node drain timeout, max-unavailable, and max-surge can affect the timing and success of upgrades.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| "\t\t\t\t\t\t$ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id> 11 \n", | |
| "\t\t\t\t\t\t\t\t\tReplace <cluster\\_name\\_or\\_id> with the cluster name or the cluster ID.\n", | |
| "\t\t\t\t\t\t\t\tExample output\n", | |
| "OpenShift Version: 4.14.8\n", | |
| "2. List the versions that you can upgrade your machine pools to by running the following command:\n", | |
| "\t\t\t\t\t\t$ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool\\_name>\n", | |
| "\t\t\t\t\t\t\tThe command returns a list of available updates, including the recommended version.\n", | |
| "\t\t\t\t\t\tExample output\n", | |
| "VERSION NOTES\n", | |
| "4.14.5 recommended\n", | |
| "4.14.4\n", | |
| "4.14.3\n", | |
| "Important\n", | |
| "\t\t\t\t\t\t\t\tDo not upgrade your machine pool to a version higher than your control plane. If you want to move to a higher version, upgrade the control plane to that version first.\n", | |
| "3. Verify the upgrade behavior of the machine pools you intend to upgrade by running the following command:\n", | |
| "\t\t\t\t\t\t$ rosa describe machinepool --cluster=<cluster\\_name\\_or\\_id> <machinepool\\_name>Example output\n", | |
| "Replicas: 5\n", | |
| "Node drain grace period: 30 minutes\n", | |
| "\n", | |
| "Management upgrade:\n", | |
| "- Type: Replace\n", | |
| "- Max surge: 20%\n", | |
| "- Max unavailable: 20%\n", | |
| "\n", | |
| "\t\t\t\t\t\t\tIn the example, these settings allow the machine pool to provision one excess node (max-surge of 20% of replicas) and to have up to one node unavailable (max-unavailable of 20% of replicas) during an upgrade. This machine pool can therefore upgrade two nodes at a time, by provisioning one new node in excess of the replica count, and by making one node unavailable and replacing it. Node upgrades may be delayed by up to 30 minutes (node-drain-grace-period of 30 minutes) if necessary to protect workloads that have a pod disruption budget.\n", | |
| "4 Upgrade a machine pool by running the following command: $ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number> You can upgrade multiple machine pools concurrently by running this command for each machine pool you want to upgrade.\n", | |
| "\n", | |
| "Upgrade a machine pool by running the following command:\n", | |
| "\n", | |
| "```\n", | |
| "$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version\\_number>\n", | |
| "```\n", | |
| "\n", | |
| "You can upgrade multiple machine pools concurrently by running this command for each machine pool you want to upgrade.\n", | |
| "\n", | |
| " - To schedule the immediate upgrade of a machine pool, run the following command:\n", | |
| "\t\t\t\t\t\t\t\t$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> --version <version\\_number>\n", | |
| "\t\t\t\t\t\t\t\t\tThe machine pool is scheduled for immediate upgrade, which initiates a rolling replacement of all nodes in the specified machine pool.\n", | |
| " - To schedule an upgrade to start at a future time, run the following command:\n", | |
| "\t\t\t\t\t\t\t\t$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version\\_number>\n", | |
| "\t\t\t\t\t\t\t\t\tThe machine pool is scheduled to begin an upgrade at the specified time and date in Coordinated Universal Time (UTC). This will initiate a rolling replacement of all nodes in the specified machine pool, beginning at the specified time.\n", | |
| "\n", | |
| "## 1.6. Upgrading with the ROSA CLI\n", | |
| "\n", | |
| "You can manually upgrade a ROSA with HCP cluster by using the ROSA CLI. This method schedules the cluster for an immediate upgrade if a more recent version is available.\n", | |
| "\n", | |
| "Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.\n", | |
| "\n", | |
| "Prerequisites\n", | |
| "\n", | |
| "- You have installed and configured the latest version of the ROSA CLI.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Verify the current version of your cluster by running the following command:\n", | |
| "\t\t\t\t\t$ rosa describe cluster --cluster=<cluster\\_name\\_or\\_id> 11 \n", | |
| "\t\t\t\t\t\t\t\tReplace <cluster\\_name\\_or\\_id> with the cluster name or the cluster ID.\n", | |
| "2 List the versions that you can upgrade your control plane and machine pools to by running the following commands:\n", | |
| "\n", | |
| "List the versions that you can upgrade your control plane and machine pools to by running the following commands:\n", | |
| "\n", | |
| " 1. For the control plane versions, run the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa list upgrade --cluster=<cluster\\_name|cluster\\_id>\n", | |
| "\t\t\t\t\t\t\t\tThe command returns a list of available updates, including the recommended version.\n", | |
| "\t\t\t\t\t\t\tExample output\n", | |
| "VERSION NOTES\n", | |
| "4.14.8 recommended\n", | |
| "4.14.7\n", | |
| "4.14.6\n", | |
| " 2. For the machine pool versions, run the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool\\_name>\n", | |
| "\t\t\t\t\t\t\t\tThe command returns a list of available updates, including the recommended version.\n", | |
| "\t\t\t\t\t\t\tExample output\n", | |
| "VERSION NOTES\n", | |
| "4.14.5 recommended\n", | |
| "4.14.4\n", | |
| "4.14.3\n", | |
| "Note\n", | |
| "\t\t\t\t\t\t\t\t\tThe latest available update for machine pools is limited to the current current version of the control plane. Ensure your control plane is up to date first.\n", | |
| "3 Upgrade your cluster with one of the following options:\n", | |
| "\n", | |
| "Upgrade your cluster with one of the following options:\n", | |
| "\n", | |
| "- Upgrade the cluster’s hosted control plane by running the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa upgrade cluster -c <cluster\\_name> --control-plane [--schedule-date=XX --schedule-time=XX] [--version <version\\_number>]\n", | |
| "\t\t\t\t\t\t\t\tYour hosted control plane is now scheduled for an upgrade.\n", | |
| "- Upgrade a specific machine pool on your cluster by running the following command:\n", | |
| "\t\t\t\t\t\t\t$ rosa upgrade machinepool -c <cluster\\_name> <machinepool\\_name> [--schedule-date=XX --schedule-time=XX] [--version <version\\_number>]\n", | |
| "\t\t\t\t\t\t\t\tYour machine pool is now scheduled for an upgrade.\n", | |
| "\n", | |
| "## 1.7. Upgrading with the OpenShift Cluster Manager console\n", | |
| "\n", | |
| "You can schedule upgrades for a ROSA cluster manually either one time or on a recurring schedule by using OpenShift Cluster Manager console.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Log in to OpenShift Cluster Manager.\n", | |
| "2. Select a cluster to upgrade.\n", | |
| "3. Click the Settings tab.\n", | |
| "4 In the Update strategy pane, select which type of update you want:\n", | |
| "\n", | |
| "In the Update strategy pane, select which type of update you want:\n", | |
| "\n", | |
| " - For individual updates, you can request the upgrade either immediately (to start within an hour) or at a future time.\n", | |
| " - For recurring updates, select a recurring date and time to start the upgrade automatically to the latest x.y.Z (z-stream) version available.\n", | |
| "\t\t\t\t\t\t\tImportant\n", | |
| "\t\t\t\t\t\t\t\t\tRecurring updates are applicable only for z-stream updates. Minor version or y-stream updates need to be done manually. You will be notified when a new y-stream update is available.\n", | |
| "5. In the Update strategy pane, click Save to apply your update strategy.\n", | |
| "6. In the Update status pane, review the Update available information and click Update.\n", | |
| "\t\t\t\t\tNote\n", | |
| "\t\t\t\t\t\t\tThe Update button is enabled only when an upgrade is available.\n", | |
| "7. The Update cluster dialog opens. Recommended cluster upgrades appear in the Select version pane. Select the version you want to upgrade your cluster to, and click Next.\n", | |
| "8 Optional: For ROSA clusters that use AWS Security Token Service (STS), the account-level and cluster-specific Operator roles might need to be updated, depending on the selected target version.\n", | |
| "\n", | |
| "Optional: For ROSA clusters that use AWS Security Token Service (STS), the account-level and cluster-specific Operator roles might need to be updated, depending on the selected target version.\n", | |
| "\n", | |
| "1. In the ROSA CLI, run the rosa list account-roles command to list and verify that the account roles are compatible with the target minor version chosen for the upgrade. If the roles are not compatible, run the rosa upgrade account-roles command to upgrade the account roles to the latest OpenShift version.\n", | |
| "2. In the ROSA CLI, run the rosa list operator-roles command to list and verify that Operator roles associated with the cluster are compatible with the target minor version chosen for the upgrade. If not, run the rosa upgrade operators-roles command to upgrade the cluster’s Operator roles to the latest OpenShift version.\n", | |
| "3. If you select an update version that requires approval, provide an administrator’s acknowledgment by typing Acknowledge into the field provided, and click Next.\n", | |
| "9 In the Schedule update dialog, schedule your cluster upgrade.\n", | |
| "\n", | |
| "In the Schedule update dialog, schedule your cluster upgrade.\n", | |
| "\n", | |
| "- To upgrade within an hour, select Update now and click Next.\n", | |
| "- To upgrade at a later time, select Schedule a different time and set a time and date for your upgrade. Click Next to proceed to the confirmation dialog.\n", | |
| "10. After reviewing the version and schedule summary, select Confirm update.\n", | |
| "11. Click Close to exit out of the Update cluster dialog.\n", | |
| "\n", | |
| "The cluster is scheduled for an upgrade to the target version. This action can take up to an hour, depending on the selected upgrade schedule and your workload configuration, such as pod disruption budgets.\n", | |
| "\n", | |
| "The status is displayed in the Update status pane.\n", | |
| "\n", | |
| "Troubleshooting\n", | |
| "\n", | |
| "- Sometimes a scheduled upgrade does not trigger. See Upgrade maintenance cancelled for more information.\n", | |
| "\n", | |
| "## 1.8. Deleting an upgrade with the OpenShift Cluster Manager console\n", | |
| "\n", | |
| "You can use the OpenShift Cluster Manager console to delete a scheduled upgrade.\n", | |
| "\n", | |
| "Procedure\n", | |
| "\n", | |
| "1. Log in to OpenShift Cluster Manager.\n", | |
| "2. Select the cluster with the scheduled upgrade.\n", | |
| "3. Click the Settings tab.\n", | |
| "4. In the Update status pane, click Cancel this update.\n", | |
| "5. Review the update details in the Cancel update dialog and click Cancel this update.\n", | |
| "\n", | |
| "You will receive an email notification confirming that the scheduled upgrade has been canceled.\n", | |
| "\n", | |
| "- Upgrade options for ROSA with HCP clusters\n", | |
| "- Life cycle policies and planning\n", | |
| "- Upgrading the hosted control plane with the ROSA CLI\n", | |
| "- Upgrading machine pools with the ROSA CLI\n", | |
| "- Upgrading the whole cluster with the ROSA CLI\n", | |
| "- Upgrading with the ROSA CLI\n", | |
| "- Upgrading with the OpenShift Cluster Manager console\n", | |
| "- Deleting an upgrade with the OpenShift Cluster Manager console\n", | |
| "\n", | |
| "<!-- image -->\n", | |
| "\n", | |
| "### Learn\n", | |
| "\n", | |
| "- Developer resources\n", | |
| "- Cloud learning hub\n", | |
| "- Interactive labs\n", | |
| "- Training and certification\n", | |
| "- Customer support\n", | |
| "- See all documentation\n", | |
| "\n", | |
| "### Try, buy, & sell\n", | |
| "\n", | |
| "- Product trial center\n", | |
| "- Red Hat Marketplace\n", | |
| "- Red Hat Ecosystem Catalog\n", | |
| "- Red Hat Store\n", | |
| "- Buy online (Japan)\n", | |
| "\n", | |
| "### Communities\n", | |
| "\n", | |
| "- Customer Portal Community\n", | |
| "- Events\n", | |
| "- How we contribute\n", | |
| "\n", | |
| "### About Red Hat Documentation\n", | |
| "\n", | |
| "We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.\n", | |
| "\n", | |
| "### Making open source more inclusive\n", | |
| "\n", | |
| "Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.\n", | |
| "\n", | |
| "### About Red Hat\n", | |
| "\n", | |
| "We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.\n", | |
| "\n", | |
| "### Red Hat legal and privacy links\n", | |
| "\n", | |
| "- About Red Hat\n", | |
| "- Jobs\n", | |
| "- Events\n", | |
| "- Locations\n", | |
| "- Contact Red Hat\n", | |
| "- Red Hat Blog\n", | |
| "- Diversity, equity, and inclusion\n", | |
| "- Cool Stuff Store\n", | |
| "- Red Hat Summit\n", | |
| "\n", | |
| "### Red Hat legal and privacy links\n", | |
| "\n", | |
| "- Privacy statement\n", | |
| "- Terms of use\n", | |
| "- All policies and guidelines\n", | |
| "- Digital accessibility\n", | |
| "-\n" | |
| ] | |
| } | |
| ] | |
| }, | |
| { | |
| "cell_type": "code", | |
| "source": [], | |
| "metadata": { | |
| "id": "ShaH9tR5f0T2" | |
| }, | |
| "execution_count": null, | |
| "outputs": [] | |
| } | |
| ], | |
| "metadata": { | |
| "colab": { | |
| "name": "scratchpad", | |
| "provenance": [], | |
| "include_colab_link": true | |
| }, | |
| "kernelspec": { | |
| "display_name": "Python 3", | |
| "name": "python3" | |
| } | |
| }, | |
| "nbformat": 4, | |
| "nbformat_minor": 0 | |
| } |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment