chore(release): copy current docs to versioned 3.0.0

_data/versions.yaml

@@ -1,20 +1,21 @@
 cryostat:
-  version: '3.0.0'
-  release-branch: 'cryostat-v3.0'
+  version: '4.0.0'
+  release-branch: 'cryostat-v4.0'
 agent:
-  version: '0.4.0'
+  version: '0.5.0'
 openshift:
-  version: '4.12'
+  version: '4.14'
 kubernetes:
-  version: '1.25'
+  version: '1.29'
 operator-sdk:
   version: '1.31.0'
 operator-lifecycle-manager:
   version: '0.25.0'
 cert-manager:
-  version: '1.11.5'
+  version: '1.13.6'
 documentation:
   - 'latest'
+  - 3.0.0
   - 2.4.0
   - 2.3.0
   - 2.2.0

guides/_subsections/add-a-trusted-certificate.md

@@ -5,7 +5,7 @@ If you have Java Management Extensions **(JMX)** over `SSL` enabled on your cont
     <li>
         {% include howto_step.html
           summary="Navigate to the <i>Security</i> Tab"
-          image-name="3.0.0/navigate-to-security.png"
+          image-name="4.0.0/navigate-to-security.png"
           text="Click the <i>Security</i> tab. This should initially be in an empty state if you have not yet defined any additional trusted certificates."
         %}
     </li>
@@ -28,7 +28,7 @@ certificate(s) within the truststore directory.
     <li>
         {% include howto_step.html
           summary="Navigate to the <i>Security</i> Tab"
-          image-name="3.0.0/navigate-to-security-with-certs.png"
+          image-name="4.0.0/navigate-to-security-with-certs.png"
           text="Click the <i>Security</i> tab. The file paths of any additional trusted certificates you have added should appear in the list."
         %}
     </li>

guides/_subsections/add-and-edit-recording-metadata-labels.md

@@ -11,7 +11,7 @@ Users can attach `Metadata` or `Custom Labels` to **JDK** `Flight Recordings` ma
   <li>
     {% include howto_step.html
       summary="Add <code>Metadata Labels</code> to the <i>Create Recording</i> form"
-      image-name="3.0.0/add-and-edit-recording-metadata-labels-1.png"
+      image-name="4.0.0/add-and-edit-recording-metadata-labels-1.png"
       text="
         When creating a custom <code>Flight Recording</code> with <b>Cryostat</b>, expand the form section <i>Show metadata options</i>. Click <i>Add Label</i> and add <i>key-Value</i> <code>Label</code> pairs to the form. Finally, click <i>Create</i> to attach the <code>Labels</code> and create the <code>Recording</code>.
       "
@@ -20,7 +20,7 @@ Users can attach `Metadata` or `Custom Labels` to **JDK** `Flight Recordings` ma
   <li>
     {% include howto_step.html
       summary="View your <code>Labels</code> on the <i>Active Recordings</i> Table"
-      image-name="3.0.0/add-and-edit-recording-metadata-labels-2.png"
+      image-name="4.0.0/add-and-edit-recording-metadata-labels-2.png"
       text="
         The new <code>Recording</code> will appear in the <i>Recordings Tab</i> with your <code>Custom Label</code> as well as default <code>Labels</code> containing information about the selected <code>Recording</code> template.
       "
@@ -31,23 +31,23 @@ Users can attach `Metadata` or `Custom Labels` to **JDK** `Flight Recordings` ma
     <p>
       <code>Recording Labels</code> can also be edited after <code>Recordings</code> have been created or re-uploaded to archives. It looks like the <code>Custom Label</code> in our example contains a typo - we can fix the typo by editing the <code>Label</code>. First select a <code>Recording</code> from the table with the 🗹 checkbox. Then, click the <i>Edit Labels</i> button to bring up the label drawer. Finally, click the <i>Edit</i> button that appears from the drawer.
       <br><br>
-      <a href="{{ site.url }}/images/3.0.0/add-and-edit-recording-metadata-labels-4.png" target="_blank">
-        <img src="{{ site.url }}/images/3.0.0/add-and-edit-recording-metadata-labels-4.png">
+      <a href="{{ site.url }}/images/4.0.0/add-and-edit-recording-metadata-labels-4.png" target="_blank">
+        <img src="{{ site.url }}/images/4.0.0/add-and-edit-recording-metadata-labels-4.png">
       </a>
       <br><br>
       The <code>Labels</code> section will appear as a form where you can <i>Add</i>, <i>Edit</i>, or <i>Delete</i> existing <code>Labels</code>, just like before when we created the <code>Recording</code>. Fix the typo, and click <i>Save</i> to save your edited <code>Labels</code>.
     </p>
     {% endcapture %}
     {% include howto_step.html
       summary="Edit an Existing <code>Label</code>"
-      image-name="3.0.0/add-and-edit-recording-metadata-labels-3.png"
+      image-name="4.0.0/add-and-edit-recording-metadata-labels-3.png"
       text=edit-an-existing-label-text
     %}
   </li>
   <li>
     {% include howto_step.html
       summary="View your edited <code>Labels</code>"
-      image-name="3.0.0/add-and-edit-recording-metadata-labels-5.png"
+      image-name="4.0.0/add-and-edit-recording-metadata-labels-5.png"
       text="
         The <code>Recording Labels</code> should be updated in the <i>Active Recordings</i> table.
       "
@@ -56,7 +56,7 @@ Users can attach `Metadata` or `Custom Labels` to **JDK** `Flight Recordings` ma
   <li>
     {% include howto_step.html
       summary="<i>(Optional)</i> Archive your <code>Recording</code> to view <code>Labels</code> copied onto the <code>Archived Recording</code>"
-      image-name="3.0.0/add-and-edit-recording-metadata-labels-6.png"
+      image-name="4.0.0/add-and-edit-recording-metadata-labels-6.png"
       text="
         On the <i>Active Recordings</i> table, click the <i>Checkbox</i> next to the <code>Recording</code>, then click <i>Archive</i> to archive your <code>Recording</code>. Notice that the <code>Archived Recording</code> also copies the <code>Labels</code> from the <code>Active Recording</code>. You can also add <code>Labels</code> to any <code>Recording</code> uploaded to <b>Cryostat’s</b> archives.
       "
@@ -67,16 +67,16 @@ Users can attach `Metadata` or `Custom Labels` to **JDK** `Flight Recordings` ma
     <p>
       Create another <code>Recording</code> on the same target. Then select both <code>Recordings</code> on the <i>Recordings Table</i> and click <i>Edit Labels</i> and start editing. This time, only <code>Labels</code> that are present on both <code>Recordings</code> will be shown in the form. Let's <i>Delete</i> the two common template-related <code>Labels</code>, and <i>Add</i> a new <code>Label</code> to both <code>Recordings</code>. Then finally, click <i>Save</i>.
       <br><br>
-      <a href="{{ site.url }}/images/3.0.0/add-and-edit-recording-metadata-labels-8.png" target="_blank">
-        <img src="{{ site.url }}/images/3.0.0/add-and-edit-recording-metadata-labels-8.png">
+      <a href="{{ site.url }}/images/4.0.0/add-and-edit-recording-metadata-labels-8.png" target="_blank">
+        <img src="{{ site.url }}/images/4.0.0/add-and-edit-recording-metadata-labels-8.png">
       </a>
       <br><br>
       Congratulations, you have successfully bulk-edited <code>Labels</code> across multiple <code>Recordings</code>!
     </p>
     {% endcapture %}
     {% include howto_step.html
       summary="<i>(Optional)</i> Bulk-edit <code>Recording Labels</code> across multiple <code>Recordings</code>"
-      image-name="3.0.0/add-and-edit-recording-metadata-labels-7.png"
+      image-name="4.0.0/add-and-edit-recording-metadata-labels-7.png"
       text=bulk-edit-recording-labels-text
     %}
   </li>

guides/_subsections/archive-a-recording.md

@@ -29,7 +29,7 @@ any state (`RUNNING`, `STOPPED`, etc.), and may even be a `snapshot`.
     {% endcapture %}
     {% include howto_step.html
       summary="Select an <i>Active Recording</i>"
-      image-name="3.0.0/archive-a-recording-1.png"
+      image-name="4.0.0/archive-a-recording-1.png"
       caption=select-recording-additional-content
     %}
   </li>
@@ -39,7 +39,7 @@ any state (`RUNNING`, `STOPPED`, etc.), and may even be a `snapshot`.
   <li>
     {% include howto_step.html
       summary="Navigate to the <i>Archived Recordings</i> tab"
-      image-name="3.0.0/archive-a-recording-2.png"
+      image-name="4.0.0/archive-a-recording-2.png"
       caption="
         Once the <code>Recording</code> has been archived, a new entry will appear in the
         <code>target</code> <b>JVM's</b> <i>Archived Recordings</i> table. All <code>Recordings</code> that were

guides/_subsections/automated-analysis.md

@@ -32,7 +32,7 @@ for use in the *Dashboard*. Read the section on the
   <li>
     {% include howto_step.html
       summary="Expand the <code>Recording</code>"
-      image-name="3.0.0/automated-analysis-1.png"
+      image-name="4.0.0/automated-analysis-1.png"
       caption="
         Expand the <code>Recording</code> with the <i>Chevron</i> to the left of the <code>Recording</code>
         name. The <code>Automated Analysis</code> report will appear below the <code>Recording</code>.
@@ -42,7 +42,7 @@ for use in the *Dashboard*. Read the section on the
   <li>
     {% include howto_step.html
       summary="View Details and Suggestions for Results"
-      image-name="3.0.0/automated-analysis-2.png"
+      image-name="4.0.0/automated-analysis-2.png"
       caption="
         Click on each result to view
         specifics on what the result means and possible suggestions to fix

guides/_subsections/common/card-catalog.md

@@ -3,7 +3,7 @@
 {% endcapture %}
 {% include howto_step.html
   summary="Open the <i>Card Catalog</i>"
-  image-name="3.0.0/dashboard/card-catalog.png"
+  image-name="4.0.0/dashboard/card-catalog.png"
   caption="Open the <i>Card Catalog</i> by clicking the <i>Catalog icon</i> on the <i>Dashboard</i> toolbar."
   text=card-catalog-include-text
 %}

guides/_subsections/common/click-create.md

@@ -1,4 +1,4 @@
 {% include howto_step.html
   summary="Click <i>Create</i>"
-  image-name="3.0.0/click-create.png"
+  image-name="4.0.0/click-create.png"
 %}

guides/_subsections/common/layout-selector.md

@@ -3,7 +3,7 @@ The <i>Layout Selector</i> contains a list of all available layouts. The current
 {% endcapture %}
 {% include howto_step.html
 summary="Open the <i>Layout Selector Dropdown</i>"
-image-name="3.0.0/dashboard/dashboard-layoutselector.png"
+image-name="4.0.0/dashboard/dashboard-layoutselector.png"
 caption="Click the <i>layout selector dropdown</i> to view the available layouts."
 text=layout-selector-text
 %}

guides/_subsections/common/navigate-to-dashboard.md

@@ -3,7 +3,7 @@
 {% endcapture %}
 {% include howto_step.html
   summary="Navigate to <i>Dashboard</i>"
-  image-name="3.0.0/navigate-to-dashboard.png"
+  image-name="4.0.0/navigate-to-dashboard.png"
   caption="Add <code>dashboard cards</code>, switch between <code>dashboard layouts</code>, and modify the <code>layout configuration</code> to suit your needs."
   text=navigate-to-dashboard-include-text
 %}

guides/_subsections/common/navigate-to-recordings.md

@@ -3,14 +3,14 @@
   necessary to add the <code>target's</code> certificate to <b>Cryostat's</b> trust store. Go
   to <a href="{{ site.url }}/guides/#add-a-trusted-certificate">Add a Trusted Certificate</a>
   and return to this section after completing that guide.
-  <a href="{{ site.url }}/images/3.0.0/navigate-to-recordings-2.png" target="_blank">
-    <img src="{{ site.url }}/images/3.0.0/navigate-to-recordings-2.png">
+  <a href="{{ site.url }}/images/4.0.0/navigate-to-recordings-2.png" target="_blank">
+    <img src="{{ site.url }}/images/4.0.0/navigate-to-recordings-2.png">
   </a>
   {{ include.additional-content }}
 {% endcapture %}
 {% include howto_step.html
   summary="Navigate to <i>Recordings</i>"
-  image-name="3.0.0/navigate-to-recordings-1.png"
+  image-name="4.0.0/navigate-to-recordings-1.png"
   caption="
     Supply <b>JMX</b> credentials to authenticate to the <code>target</code>, if necessary. If
     the <code>target</code> is not configured with <b>JMX</b> authentication then the

guides/_subsections/common/navigate-to-settings.md

@@ -6,7 +6,7 @@
 {% endcapture %}
 {% include howto_step.html
   summary="Navigate to <i>Settings</i>"
-  image-name="3.0.0/navigate-to-settings.png"
+  image-name="4.0.0/navigate-to-settings.png"
   caption="
     Click the <i>cog</i> or <i>gear</i> icon in the application masthead to access the <i>Settings</i> view.
   "

guides/_subsections/common/navigate-to-topology.md

@@ -3,7 +3,7 @@
 {% endcapture %}
 {% include howto_step.html
   summary="Navigate to <i>Topology</i>"
-  image-name="3.0.0/navigate-to-topology.png"
+  image-name="4.0.0/navigate-to-topology.png"
   caption="Use the bottom <i>Control Bar</i> to adjust the <i>Graph View</i> as needed."
   text=navigate-to-topology-include-text
 %}

guides/_subsections/common/select-a-recording.md

@@ -6,7 +6,7 @@
 {% endcapture %}
 {% include howto_step.html
   summary="Select a <code>Recording</code>"
-  image-name="3.0.0/select-a-recording.png"
+  image-name="4.0.0/select-a-recording.png"
   caption=caption-content
   text=text-content
 %}

guides/_subsections/common/select-target-application.md

@@ -7,7 +7,7 @@
 {% endcapture %}
 {% include howto_step.html
   summary="Select the <i>Target Application</i>"
-  image-name="3.0.0/select-target-application.png"
+  image-name="4.0.0/select-target-application.png"
   caption="Clik the <i>Dropdown arrow</i> on the right side of <i>Target</i> prompt to select or create a <code>target</code>."
   text=text-content
 %}

guides/_subsections/configure-graphical-notifications.md

@@ -12,7 +12,7 @@ the **web-client** graphical console can become quite noisy.
   <li>
     {% include howto_step.html
       summary="Locate the <i>Notifications</i> Setting"
-      image-name="3.0.0/notifications-setting.png"
+      image-name="4.0.0/notifications-setting.png"
       text="
         The <i>Notifications</i> setting within this view is used to control the graphical display of notifications that
         correspond to <code>WebSocket</code> messages sent by the <b>Cryostat</b> backend when actions and state changes occur. The setting

guides/_subsections/create-a-custom-target.md

@@ -20,8 +20,8 @@ without going through the network stack.
       Search for <i>Custom Target</i> tab and click <i>Create</i> to open the
       <i>Custom Target</i> form.
       <figure>
-        <a href="{{ site.url }}/images/3.0.0/custom-target-1.png" target="_blank">
-          <img src="{{ site.url }}/images/3.0.0/custom-target-1.png">
+        <a href="{{ site.url }}/images/4.0.0/custom-target-1.png" target="_blank">
+          <img src="{{ site.url }}/images/4.0.0/custom-target-1.png">
         </a>
         <figcaption>
           Use the <i>Custom Target</i> form to tell <b>Cryostat</b> about <b>JVM</b>
@@ -32,15 +32,15 @@ without going through the network stack.
     {% endcapture %}
     {% include howto_step.html
       summary="Open the <i>Custom Target</i> Form"
-      image-name="3.0.0/topology-7.png"
+      image-name="4.0.0/topology-7.png"
       caption="Click on <i>Catalog Icon</i> to open the <i>Topology Entity Catalog</i>."
       text=open-custom-target-form-text
     %}
   </li>
   <li>
     {% include howto_step.html
       summary="Enter <i>Custom Target</i> Definition"
-      image-name="3.0.0/custom-target-2.png"
+      image-name="4.0.0/custom-target-2.png"
       caption="Use the form to enter the <i>Custom Target</i> definition."
       text="
       The <i>Connection URL</i> is required for <b>Cryostat</b> to attempt to
@@ -55,8 +55,8 @@ without going through the network stack.
         Once you enter a valid <i>Connection URL</i>, click on the sample <code>node</code> to test
         the <code>target</code> connection.
         <figure>
-          <a href="{{ site.url }}/images/3.0.0/custom-target-4.png" target="_blank">
-            <img src="{{ site.url }}/images/3.0.0/custom-target-4.png">
+          <a href="{{ site.url }}/images/4.0.0/custom-target-4.png" target="_blank">
+            <img src="{{ site.url }}/images/4.0.0/custom-target-4.png">
           </a>
           <figcaption>
             An exclamation mark and an alert banner will show if an error
@@ -73,7 +73,7 @@ without going through the network stack.
     {% endcapture %}
     {% include howto_step.html
       summary="Test the <i>Custom Target</i> Definition"
-      image-name="3.0.0/custom-target-3.png"
+      image-name="4.0.0/custom-target-3.png"
       caption="A &#9989; checkmark will show if <b>Cryostat</b> can connect to the sample app."
       text=test-custom-target-text
     %}
@@ -85,7 +85,7 @@ without going through the network stack.
   <li>
     {% include howto_step.html
       summary="View the <i>Custom Targets</i>"
-      image-name="3.0.0/custom-target-5.png"
+      image-name="4.0.0/custom-target-5.png"
       caption="The <i>Custom Target</i> will be available under <i>Custom Targets</i> realm."
       text="
           Once the <i>Custom Target</i> form is successfully submitted, you
@@ -97,7 +97,7 @@ without going through the network stack.
   <li>
     {% include howto_step.html
       summary="<i>(Optional)</i> Delete <i>Custom Targets</i>"
-      image-name="3.0.0/custom-target-6.png"
+      image-name="4.0.0/custom-target-6.png"
       caption="<i>Custom Targets</i> can be cleaned up with <i>Actions</i> menu."
       text="
       If the <i>Custom Targets</i> is no longer needed, in the target detail

guides/_subsections/create-an-automated-rule.md

@@ -17,7 +17,7 @@ Previously, if we wanted to enable always-on `Continuous` monitoring using **JDK
   <li>
       {% include howto_step.html
       summary="Navigate to the <i>Automated Rules</i> Tab"
-      image-name="3.0.0/create-an-automated-rule-1.png"
+      image-name="4.0.0/create-an-automated-rule-1.png"
       caption="Switch to the <i>Automated Rules</i> tab."
     %}
   </li>
@@ -27,7 +27,7 @@ Previously, if we wanted to enable always-on `Continuous` monitoring using **JDK
   <li>
       {% include howto_step.html
         summary="Configure the new <code>Automated Rule</code>"
-        image-name="3.0.0/create-an-automated-rule-2.png"
+        image-name="4.0.0/create-an-automated-rule-2.png"
         text="
       <p>
         <i>Name:</i> Enter a name for the new rule. The form will alert you if the name
@@ -114,7 +114,7 @@ target.alias.matches("^customer-login[0-9]\*$")
   <li>
       {% include howto_step.html
         summary="Check your <code>Match Expression</code>"
-        image-name="3.0.0/create-an-automated-rule-3.png"
+        image-name="4.0.0/create-an-automated-rule-3.png"
         caption="You can select a <code>target</code> <b>JVM</b> to view its properties and use them to build your <code>Match Expression</code>."
         text="
           <p>
@@ -126,7 +126,7 @@ target.alias.matches("^customer-login[0-9]\*$")
   <li>
       {% include howto_step.html
         summary="<i>(Optional)</i> Adjust <i>Rule Parameters</i>"
-        image-name="3.0.0/create-an-automated-rule-4.png"
+        image-name="4.0.0/create-an-automated-rule-4.png"
         caption="
           Optionally set the <code>Recording</code> Options and <i>Rule Parameters.</i>"
         text="
@@ -148,7 +148,7 @@ target.alias.matches("^customer-login[0-9]\*$")
   <li>
       {% include howto_step.html
         summary="Observe the new Rule in the <i>Automated Rules</i> Table"
-        image-name="3.0.0/create-an-automated-rule-5.png"
+        image-name="4.0.0/create-an-automated-rule-5.png"
         caption="
           The new rule will appear in the <i>Automated Rules</i> table."
       %}
@@ -159,7 +159,7 @@ target.alias.matches("^customer-login[0-9]\*$")
   <li>
       {% include howto_step.html
         summary="Observe the automatically generated <code>Recording</code> in the <i>Active Recordings</i> Table"
-        image-name="3.0.0/create-an-automated-rule-6.png"
+        image-name="4.0.0/create-an-automated-rule-6.png"
         caption="
           Switch to the <i>Recordings</i> tab and view the new <code>Recording</code> in the <i>Active Recordings</i>
           table."

guides/_subsections/download-an-active-or-archived-recording.md

@@ -26,7 +26,7 @@ or [`jfr`](https://dev.java/learn/jvm/jfr/tools/) for the heavy lifting on your
   <li>
     {% include howto_step.html
       summary="Download the <code>Recording</code>"
-      image-name="3.0.0/download-an-active-or-archived-recording-1.png"
+      image-name="4.0.0/download-an-active-or-archived-recording-1.png"
       caption="
         Click the action overflow \"&#65049;\" <i>three-dot</i> menu on the right side of the
         recording entry in the table, then click <i>Download Recording</i>.
@@ -36,7 +36,7 @@ or [`jfr`](https://dev.java/learn/jvm/jfr/tools/) for the heavy lifting on your
   <li>
     {% include howto_step.html
       summary="Choose what to do with the <code>Recording</code> File"
-      image-name="3.0.0/download-an-active-or-archived-recording-2.png"
+      image-name="4.0.0/download-an-active-or-archived-recording-2.png"
       caption="
         Your browser will present you with its standard file-save dialog for both
         the <code>Archived Recording</code>, and a <code>.metadata.json</code> file containing any