Skip to content

Commit cac449a

Browse files
author
GitHub Action
committed
Deployed 47b24ca to '1.1.0' with ProperDocs 1.6.7 and mike 2.2.0
1 parent ae52e12 commit cac449a

2 files changed

Lines changed: 78 additions & 3 deletions

File tree

'1.1.0'/search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

'1.1.0'/update-openshift.html

Lines changed: 77 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
<meta charset="utf-8">
1010
<meta name="viewport" content="width=device-width,initial-scale=1">
1111

12-
<meta name="description" content="The upgrade on OpenShift consists of two steps:">
12+
<meta name="description" content="Documentation">
1313

1414

1515
<meta name="author" content="Percona LLC">
@@ -4681,6 +4681,17 @@
46814681
</label>
46824682
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
46834683

4684+
<li class="md-nav__item">
4685+
<a href="#considerations-for-using-openshift-422" class="md-nav__link">
4686+
<span class="md-ellipsis">
4687+
4688+
Considerations for using OpenShift 4.22
4689+
4690+
</span>
4691+
</a>
4692+
4693+
</li>
4694+
46844695
<li class="md-nav__item">
46854696
<a href="#upgrade-the-operator-via-operator-lifecycle-manager-olm" class="md-nav__link">
46864697
<span class="md-ellipsis">
@@ -4730,6 +4741,17 @@
47304741
</span>
47314742
</a>
47324743

4744+
</li>
4745+
4746+
<li class="md-nav__item">
4747+
<a href="#update-via-the-command-line-interface" class="md-nav__link">
4748+
<span class="md-ellipsis">
4749+
4750+
Update via the command-line interface
4751+
4752+
</span>
4753+
</a>
4754+
47334755
</li>
47344756

47354757
</ul>
@@ -4768,6 +4790,12 @@
47684790

47694791

47704792
<h1 id="upgrade-the-operator-and-crd-via-operator-lifecycle-manager-olm">Upgrade the Operator and CRD via Operator Lifecycle Manager (OLM)<a class="headerlink" href="#upgrade-the-operator-and-crd-via-operator-lifecycle-manager-olm" title="Permanent link">&para;</a></h1>
4793+
<h2 id="considerations-for-using-openshift-422">Considerations for using OpenShift 4.22<a class="headerlink" href="#considerations-for-using-openshift-422" title="Permanent link">&para;</a></h2>
4794+
<p>Starting with OpenShift 4.22, the way images with not fully qualified names are pulled has changed for repositories that share the same repository name on DockerHub and Red Hat Marketplace. By default the tags are pulled from Red Hat Marketplace. Specifying not fully qualified image names may result in the <code>ImagePullBackOff</code> error.</p>
4795+
<ul>
4796+
<li><strong>OLM installation:</strong> Images are provided with the fully qualified names and are pulled from the Red Hat Marketplace/DockerHub registry.</li>
4797+
<li><strong>Manual install/update with default manifests:</strong> Images must use the <code>docker.io</code> registry prefix to guarantee successful download from the DockerHub <code>percona-server-mysql-operator</code> repository. See the <a href="#update-via-the-command-line-interface">Update via the command-line interface</a> section for the exact steps.</li>
4798+
</ul>
47714799
<p>The upgrade on OpenShift consists of two steps:</p>
47724800
<ul>
47734801
<li>Upgrade the Operator Deployment</li>
@@ -4827,12 +4855,59 @@ <h3 id="upgrade-the-operator">Upgrade the Operator<a class="headerlink" href="#u
48274855
<p>Click the &ldquo;Upgrade available&rdquo; link to review details, click &ldquo;Preview InstallPlan,&rdquo; and then click &ldquo;Approve&rdquo; to upgrade the Operator.</p>
48284856
</li>
48294857
</ol>
4858+
<h3 id="update-via-the-command-line-interface">Update via the command-line interface<a class="headerlink" href="#update-via-the-command-line-interface" title="Permanent link">&para;</a></h3>
4859+
<p>The following steps apply if you plan to use OpenShift 4.22. See the <a href="#considerations-for-using-openshift-422">Considerations for using OpenShift 4.22</a>.</p>
4860+
<ol>
4861+
<li>
4862+
<p>Check all clusters managed by the Operator to see if <code>initContainer.image</code> is set.</p>
4863+
<ul>
4864+
<li>If defined: skip the next step.</li>
4865+
<li>If undefined: proceed to step 2.</li>
4866+
</ul>
4867+
</li>
4868+
<li>
4869+
<p>Apply a patch to the clusters with undefined <code>initContainer.image</code> to define this image with the <code>docker.io</code> registry in the image path:</p>
4870+
<div class="highlight"><pre><span></span><code>kubectl<span class="w"> </span>patch<span class="w"> </span>ps<span class="w"> </span>ps-cluster1<span class="w"> </span>--type<span class="o">=</span>merge<span class="w"> </span>--patch<span class="w"> </span><span class="s1">&#39;{</span>
4871+
<span class="s1"> &quot;spec&quot;: {</span>
4872+
<span class="s1"> &quot;initcontainer&quot;: {</span>
4873+
<span class="s1"> &quot;image&quot;: &quot;docker.io/percona-server-mysql-operator:1.1.0&quot;</span>
4874+
<span class="s1"> }</span>
4875+
<span class="s1"> }</span>
4876+
<span class="s1">}&#39;</span>
4877+
</code></pre></div>
4878+
<p><strong>Important!</strong> This command triggers the restart of your clusters. Wait till they restart and report the <code>Ready</code> status.</p>
4879+
</li>
4880+
<li>
4881+
<p>Update the Operator deployment and specify the <code>docker.io</code> registry name in the image path:</p>
4882+
<div class="highlight"><pre><span></span><code>kubectl<span class="w"> </span>patch<span class="w"> </span>deployment<span class="w"> </span>percona-server-mysql-operator<span class="w"> </span><span class="se">\</span>
4883+
-p<span class="s1">&#39;{&quot;spec&quot;:{&quot;template&quot;:{&quot;spec&quot;:{&quot;containers&quot;:[{&quot;name&quot;:&quot;percona-server-mysql-operator&quot;,&quot;image&quot;:&quot;docker.io/percona/percona-server-mysql-operator:1.1.0&quot;}]}}}}&#39;</span>
4884+
</code></pre></div>
4885+
</li>
4886+
<li>
4887+
<p>Update the Custom Resource version and the database cluster. Specify the <code>initContainer</code> image with the <code>docker.io</code> registry name in the path.</p>
4888+
<p>The following example shows how to update Percona Server for MySQL cluster 8.4 with Group Replication and HAProxy:</p>
4889+
<div class="highlight"><pre><span></span><code>kubectl<span class="w"> </span>patch<span class="w"> </span>ps<span class="w"> </span>ps-cluster1<span class="w"> </span>--type<span class="o">=</span>merge<span class="w"> </span>--patch<span class="w"> </span><span class="s1">&#39;{</span>
4890+
<span class="s1"> &quot;spec&quot;: {</span>
4891+
<span class="s1"> &quot;crVersion&quot;: &quot;1.1.0&quot;,</span>
4892+
<span class="s1"> &quot;initContainer&quot;: &quot;docker.io/percona/percona-server-mysql-operator:1.1.0&quot;,</span>
4893+
<span class="s1"> &quot;mysql&quot;:{ &quot;image&quot;: &quot;docker.io/percona/percona/percona-server:8.4.8-8.1&quot; },</span>
4894+
<span class="s1"> &quot;proxy&quot;:{</span>
4895+
<span class="s1"> &quot;haproxy&quot;:{ &quot;image&quot;: &quot;docker.io/percona/haproxy:2.8.18-1&quot; }</span>
4896+
<span class="s1"> },</span>
4897+
<span class="s1"> &quot;backup&quot;:{ &quot;image&quot;: &quot;docker.io/percona/percona-xtrabackup:8.4.0-5.1&quot; },</span>
4898+
<span class="s1"> &quot;toolkit&quot;:{ &quot;image&quot;: &quot;docker.io/percona/percona-toolkit:3.7.1&quot; },</span>
4899+
<span class="s1"> &quot;pmm&quot;:{ &quot;image&quot;: &quot;docker.io/percona/pmm-client:3.7.0&quot; }</span>
4900+
<span class="s1"> }</span>
4901+
<span class="s1">}&#39;</span>
4902+
</code></pre></div>
4903+
</li>
4904+
</ol>
48304905
<hr>
48314906
<div class="md-source-file">
48324907
<small>
48334908

48344909
Last update:
4835-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 17, 2026 17:28:22 UTC">April 17, 2026</span>
4910+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="July 3, 2026 17:42:36 UTC">July 3, 2026</span>
48364911

48374912
<br>
48384913
Created:

0 commit comments

Comments
 (0)