Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(version): copy guides to 2.3.0 version and update latest to 2.4.0 #141

Merged
merged 9 commits into from
Dec 11, 2023
13 changes: 9 additions & 4 deletions _data/versions.yaml
Original file line number Diff line number Diff line change
@@ -1,16 +1,21 @@
cryostat:
version: 2.3.0
release-branch: cryostat-v2.3
version: '2.4.0'
release-branch: 'cryostat-v2.4'
agent:
version: '0.3.0'
openshift:
version: '4.10'
kubernetes:
version: '1.19'
operator-sdk:
version: '1.28.0'
version: '1.31.0'
operator-lifecycle-manager:
version: '0.24.0'
version: '0.25.0'
cert-manager:
version: '1.11.5'
documentation:
- 'latest'
- 2.3.0
- 2.2.0
- 2.1.0
- 2.0.0
Expand Down
2 changes: 1 addition & 1 deletion demo/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Core JFR functionality is not available in this stubbed out demo, but you can us
<iframe
id="demo-frame"
class="demo-iframe"
src="https://cryostatio-cryostat-web-cryostat-v23.surge.sh"
src="https://cryostatio-cryostat-web-{{ site.data.versions.cryostat.release-branch | remove: '.' }}.surge.sh"
></iframe>
</div>
<script>
Expand Down
382 changes: 131 additions & 251 deletions get-started/index.md

Large diffs are not rendered by default.

20 changes: 10 additions & 10 deletions guides/_subsections/add-a-trusted-certificate.md
Original file line number Diff line number Diff line change
@@ -1,38 +1,38 @@
## [Add a Trusted Certificate](#add-a-trusted-certificate)
If you have Java Management Extensions (JMX) over SSL enabled on your containerized JVMs, you must configure Cryostat to trust the SSL certificate presented by the containerized JVM when Cryostat attempts to open a JMX connection. If you do not complete this configuration, Cryostat cannot open a JMX connection for the purposes of performing JFR management tasks.
If you have Java Management Extensions **(JMX)** over `SSL` enabled on your containerized **JVMs**, you must configure **Cryostat** to trust the `SSL` certificate presented by the containerized **JVM** when **Cryostat** attempts to open a **JMX** connection. If you do not complete this configuration, **Cryostat** cannot open a **JMX** connection for the purposes of performing **JFR** management tasks.

Here's how to add a trusted SSL certificate with the Cryostat web UI.
Here's how to add a trusted `SSL` certificate with the **Cryostat Web** UI.

<ol>
<li>
{% include howto_step.html
summary="Navigate to the Security tab"
image-name="2.3.0/navigate-to-security.png"
summary="Navigate to the <i>Security</i> Tab"
image-name="2.4.0/navigate-to-security.png"
text="Click the <i>Security</i> tab."
%}
</li>
<li>
{% include howto_step.html
summary="Upload the Certificate"
image-name="2.3.0/add-a-trusted-certificate-upload.png"
image-name="2.4.0/add-a-trusted-certificate-upload.png"
text="
Click the <i>Upload</i> button on the <i>Import SSL Certificates</i> card. This action opens a file-upload dialog, where you can choose the certificate that you want to upload to Cryostat. You can repeat this process multiple times to add multiple trusted certificates.
Click the <i>Upload</i> button on the <i>Import SSL Certificates</i> card. This action opens a file-upload dialog, where you can choose the certificate that you want to upload to <b>Cryostat</b>. You can repeat this process multiple times to add multiple trusted certificates.
"
%}
</li>
<li>
Restart Cryostat to apply the changes. If you do not restart your Cryostat instance, the added certificates are not reloaded. This causes connections to fail because the Cryostat JMX client cannot trust the certificates. Depending on your deployment platform and configuration, restarting Cryostat might require any of the following:
Restart <b>Cryostat</b> to apply the changes. If you do not restart your <b>Cryostat</b> instance, the added certificates are not reloaded. This causes connections to fail because the <b>Cryostat JMX</b> client cannot trust the certificates. Depending on your deployment platform and configuration, restarting <b>Cryostat</b> might require any of the following:
<ul>
<li>
On OpenShift/Kubernetes with Cryostat Operator:
On <b>OpenShift/Kubernetes</b> with <b>Cryostat Operator</b>:
<pre>oc delete cryostat/&lt;my-cryostat-cr-name&gt;<br>oc create -f &lt;my-cryostat-cr-name&gt;.yaml</pre>
</li>
<li>
On OpenShift/Kubernetes without Cryostat Operator:
On <b>OpenShift/Kubernetes</b> without <b>Cryostat Operator</b>:
<pre>oc rollout retry dc/&lt;my-cryostat-dc-name&gt;</pre>
</li>
<li>
On Podman:
On <b>Podman</b>:
<pre>podman restart &lt;my-cryostat-container-id&gt;</pre>
</li>
</ul>
Expand Down
50 changes: 25 additions & 25 deletions guides/_subsections/add-and-edit-recording-metadata-labels.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
## [Add and Edit Recording Metadata Labels](#add-and-edit-recording-metadata-labels)
Users can attach metadata or custom labels to JDK flight recordings managed by Cryostat. Recording labels can be used to identify recordings during queries or perform actions on multiple recordings containing the same labels. Here’s how to add and edit metadata labels on your JDK flight recordings.
Users can attach `Metadata` or `Custom Labels` to **JDK** `Flight Recordings` managed by **Cryostat**. `Recording Labels` can be used to identify `Recordings` during queries or perform actions on multiple `Recordings` containing the same `Labels`. Here’s how to *Add* and *Edit* `Metadata Labels` on your **JDK** `Flight Recordings`.

<ol>
<li>
Expand All @@ -10,73 +10,73 @@ Users can attach metadata or custom labels to JDK flight recordings managed by C
</li>
<li>
{% include howto_step.html
summary="Add metadata labels to the Create Recording form"
image-name="2.3.0/add-and-edit-recording-metadata-labels-1.png"
summary="Add <code>Metadata Labels</code> to the <i>Create Recording</i> form"
image-name="2.4.0/add-and-edit-recording-metadata-labels-1.png"
text="
When creating a custom flight recording with Cryostat, expand the form section <i>Show metadata options</i>. Click <i>Add Label</i> and add key-value label pairs to the form. Finally, click <i>Create</i> to attach the labels and create the recording.
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>.
"
%}
</li>
<li>
{% include howto_step.html
summary="View your labels on the Active Recordings Table"
image-name="2.3.0/add-and-edit-recording-metadata-labels-2.png"
summary="View your <code>Labels</code> on the <i>Active Recordings</i> Table"
image-name="2.4.0/add-and-edit-recording-metadata-labels-2.png"
text="
The new recording will appear in the Recordings tab with your custom label as well as default labels containing information about the selected recording template.
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.
"
%}
</li>
<li>
{% capture edit-an-existing-label-text %}
<p>
Recording labels can also be edited after recordings have been created or re-uploaded to archives. It looks like the custom label in our example contains a typo - we can fix the typo by editing the label. First select a recording 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.
<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/2.3.0/add-and-edit-recording-metadata-labels-4.png" target="_blank">
<img src="{{ site.url }}/images/2.3.0/add-and-edit-recording-metadata-labels-4.png">
<a href="{{ site.url }}/images/2.4.0/add-and-edit-recording-metadata-labels-4.png" target="_blank">
<img src="{{ site.url }}/images/2.4.0/add-and-edit-recording-metadata-labels-4.png">
</a>
<br><br>
The labels section will appear as a form where you can add, edit, or delete existing labels, just like before when we created the recording. Fix the typo, and click <i>Save</i> to save your edited labels.
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 label"
image-name="2.3.0/add-and-edit-recording-metadata-labels-3.png"
summary="Edit an Existing <code>Label</code>"
image-name="2.4.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 labels"
image-name="2.3.0/add-and-edit-recording-metadata-labels-5.png"
summary="View your edited <code>Labels</code>"
image-name="2.4.0/add-and-edit-recording-metadata-labels-5.png"
text="
The recording labels should be updated in the Active Recordings table.
The <code>Recording Labels</code> should be updated in the <i>Active Recordings</i> table.
"
%}
</li>
<li>
{% include howto_step.html
summary="<i>(Optional)</i> Archive your recording to view labels copied onto the archived recording"
image-name="2.3.0/add-and-edit-recording-metadata-labels-6.png"
summary="<i>(Optional)</i> Archive your <code>Recording</code> to view <code>Labels</code> copied onto the <code>Archived Recording</code>"
image-name="2.4.0/add-and-edit-recording-metadata-labels-6.png"
text="
On the Active Recordings table, click the checkbox next to the recording, then click <i>Archive</i> to archive your recording. Notice that the archived recording also copies the labels from the active recording. You can also add labels to any recording uploaded to Cryostat’s archives.
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.
"
%}
</li>
<li>
{% capture bulk-edit-recording-labels-text %}
<p>
Create another recording on the same target. Then select both recordings on the Recordings Table and click <i>Edit Labels</i> and <i>Edit</i>.This time, only labels that are present on both recordings will be shown in the form. Let's delete the two common template-related labels, and add a new label to both recordings. Then finally, click <i>Save</i>.
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/2.3.0/add-and-edit-recording-metadata-labels-8.png" target="_blank">
<img src="{{ site.url }}/images/2.3.0/add-and-edit-recording-metadata-labels-8.png">
<a href="{{ site.url }}/images/2.4.0/add-and-edit-recording-metadata-labels-8.png" target="_blank">
<img src="{{ site.url }}/images/2.4.0/add-and-edit-recording-metadata-labels-8.png">
</a>
<br><br>
Congratulations, you have successfully bulk-edited labels across multiple recordings!
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 recording labels across multiple recordings"
image-name="2.3.0/add-and-edit-recording-metadata-labels-7.png"
summary="<i>(Optional)</i> Bulk-edit <code>Recording Labels</code> across multiple <code>Recordings</code>"
image-name="2.4.0/add-and-edit-recording-metadata-labels-7.png"
text=bulk-edit-recording-labels-text
%}
</li>
Expand Down
44 changes: 22 additions & 22 deletions guides/_subsections/archive-a-recording.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
## [Archive a Recording](#archive-a-recording)
In contrast to <i>Active Recordings</i>, which reside within the container
of the target application, <i>Archived Recordings</i> reside within persistent
storage attached to a Cryostat instance. In OpenShift, for example, the
In contrast to `Active Recordings`, which reside within the container
of the `target` application, `Archived Recordings` reside within persistent
storage attached to a **Cryostat** instance. In **OpenShift**, for example, the
archives are stored in a `PersistentVolumeClaim`.

Archived recordings are created by performing archival upon active recordings.
When this is requested, Cryostat connects to the target application and copies
the Flight Recorder data from the selected active recording into an archived
recording file in storage. The active source recording may be continuous or
fixed-duration, may be using any event template, may be in
any state (`RUNNING`, `STOPPED`, etc.), and may even be a snapshot.
`Archived Recordings` are created by performing archival upon `Active Recordings`.
When this is requested, **Cryostat** connects to the `target` application and copies
the `Flight Recorder` data from the selected `Active Recording` into an `Archived
Recording` file in storage. The `Active Source Recording` may be `Continuous` or
`Fixed-duration`, using any *Event Template*, in
any state (`RUNNING`, `STOPPED`, etc.), and may even be a `snapshot`.

<ol>
<li>
Expand All @@ -21,15 +21,15 @@ any state (`RUNNING`, `STOPPED`, etc.), and may even be a snapshot.
<li>
{% capture select-recording-additional-content %}
<p>
If you do not have any recordings present in the Active Recordings
If you do not have any <code>Recordings</code> present in the <i>Active Recordings</i>
view, follow
<a href="{{ page.url }}#startstop-a-recording">Start/Stop a Recording</a>
to create one, or select a different target application.
to create one, or select a different <code>target</code> application.
</p>
{% endcapture %}
{% include howto_step.html
summary="Select an Active Recording"
image-name="2.3.0/archive-a-recording-1.png"
summary="Select an <i>Active Recording</i>"
image-name="2.4.0/archive-a-recording-1.png"
caption=select-recording-additional-content
%}
</li>
Expand All @@ -39,16 +39,16 @@ 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="2.3.0/archive-a-recording-2.png"
image-name="2.4.0/archive-a-recording-2.png"
caption="
Once the recording has been archived, a new entry will appear in the
target JVM's <i>Archived Recordings</i> table. All recordings that were
saved from the current target will be listed here in their own table.
Switching to a different target from the dropdown will list only the
recordings archived from that source target. The name of the archived
recording reflects the address of the target application, the original
name of the active recording that it was retrieved from, and includes a
timestamp indicating when the archived recording was created.
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
saved from the current <code>target</code> will be listed here in their own table.
Switching to a different <code>target</code> from the dropdown will list only the
<code>Recordings</code> archived from that source <code>target</code>. The name of the <code>Archived
Recording</code> reflects the address of the <code>target</code> application, the original
name of the <code>Active Recording</code> that it was retrieved from, and includes a
<code>timestamp</code> indicating when the <code>Archived Recording</code> was created.
"
%}
</li>
Expand Down
Loading