Skip to content

Commit

Permalink
Deploying to main from @ 49bdd293ef918c3b0ef651a3db2fbb63ff4f0eea 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
@stianst
stianst committed Jan 29, 2025
1 parent e377522 commit 5a5b881
Show file tree
Hide file tree
Showing 5 changed files with 104 additions and 16 deletions.
3 changes: 3 additions & 0 deletions 2024/01/keycloak-2305-released.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,9 @@
<h1>Keycloak 23.0.5 released</h1>
<p class="blog-date text-muted">January 29 2024</p>

<div class="alert alert-warning" role="alert">
This post is more than one year old. The contents within the blog is likely to be out of date.
</div>

<p>To download the release go to <a href="https://www.keycloak.org/downloads.html">Keycloak downloads</a>.</p>

Expand Down
15 changes: 0 additions & 15 deletions nightly/guides.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -786,21 +786,6 @@ <h5 class="card-title">
Keycloak Node.js adapter


</h5>
<span class="card-text">Node.js adapter to protect server-side JavaScript apps</span>
<div>
</div>
<a href="https://www.keycloak.org/nightly/securing-apps/nodejs-adapter" class="stretched-link link-dark"></a>
</div>
</div>
</div>
<div class="col-sm-4">
<div class="card shadow-sm mb-4">
<div class="card-body">
<h5 class="card-title">
Keycloak Node.js adapter


</h5>
<span class="card-text">Node.js adapter to protect server-side JavaScript apps</span>
<div>
Expand Down
90 changes: 90 additions & 0 deletions nightly/operator/advanced-configuration.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -639,6 +639,96 @@ <h4 id="_example_with_openshift">Example with OpenShift</h4>
</div>
</div>
</div>
<div class="sect2">
<h3 id="_managing_keycloak_operator_updates_preview">Managing Keycloak Operator Updates (Preview)</h3>
<div class="paragraph">
<p>The Keycloak Operator offers updates strategies to control how the Operator handles changes to the Keycloak CR.</p>
</div>
<div class="paragraph">
<p><strong>Supported Updates Types:</strong></p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">Rolling Updates</dt>
<dd>
<p>Update the StatefulSet in a rolling fashion, minimizing downtime (requires multiple replicas).</p>
</dd>
<dt class="hdlist1">Recreate Updates</dt>
<dd>
<p>Scale down the StatefulSet before applying updates, causing temporary downtime.</p>
</dd>
</dl>
</div>
<div class="sect3">
<h4 id="_configuring_the_update_strategy">Configuring the Update Strategy</h4>
<div class="paragraph">
<p>The update strategy is specified within the <code>spec</code> section of the Keycloak CR YAML definition.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>During this preview stage, the update strategy defaults to mimicking Keycloak 26.1 or older behavior:
When the Keycloak CR&#8217;s image field changes, the Operator scales down the StatefulSet before applying the new image, resulting in downtime.
Any configuration change will be a rolling update.</p>
</div>
</td>
</tr>
</table>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-yaml" data-lang="yaml">apiVersion: k8s.keycloak.org/v2alpha1
kind: Keycloak
metadata:
name: example-kc
spec:
update:
strategy: Recreate|&lt;not set&gt; <i class="conum" data-value="1"></i><b>(1)</b></code></pre>
</div>
</div>
<div class="colist arabic">
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
<td>Set the desired update strategy here (Recreate in this example).</td>
</tr>
</table>
</div>
<table class="tableblock frame-all grid-all fit-content">
<caption class="title">Table 1. Possible field values</caption>
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Value</th>
<th class="tableblock halign-left valign-top">Downtime?</th>
<th class="tableblock halign-left valign-top">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&lt;not set&gt;</code> (default)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On image name or tag change</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mimics Keycloak 26.1 or older behavior.
When the image field changes, the StatefulSet is scaled down before applying the new image.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Recreate</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On any configuration or image change</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The StatefulSet is scaled down before applying the new configuration or image.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div> </div>
</div>
Expand Down
2 changes: 1 addition & 1 deletion nightly/securing-apps/overview.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ <h4 id="_node_js_server_side">Node.js (server-side)</h4>
<div class="ulist">
<ul>
<li>
<p><a href="https://www.keycloak.org/nightly/securing-apps/nodejs-adapter">Keycloak Node.js adapter</a></p>
<p><a href="https://www.keycloak.org/securing-apps/nodejs-adapter">Keycloak Node.js adapter</a></p>
</li>
</ul>
</div>
Expand Down
10 changes: 10 additions & 0 deletions nightly/server/importExport.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -230,6 +230,16 @@ <h2 id="_exporting_a_specific_realm">Exporting a specific realm</h2>
</div>
</div>
<div class="sect1">
<h2 id="_import_file_naming_conventions">Import File Naming Conventions</h2>
<div class="sectionbody">
<div class="paragraph">
<p>When you export a realm specific file name conventions are used, which must also be used for importing from a directory or import at startup. The realm file to be imported must be named &lt;realm name&gt;-realm.json.
Regular and federated user files associated with a realm must be named &lt;realm-name&gt;-users-&lt;file number&gt;.json and &lt;realm-name&gt;-federated-users-&lt;file number&gt;.json. Failure to use this convention will result in errors or
user files not being imported.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_importing_a_realm_from_a_directory">Importing a Realm from a Directory</h2>
<div class="sectionbody">
<div class="paragraph">
Expand Down

0 comments on commit 5a5b881

Please sign in to comment.