Merge pull request #92728 from agantony/ROX28809-rhacs-docs-main

[RHACS] [Docs] ROX-28809: Updates to the Dev Hub integration documentation

Author: agantony

configuration/configuring-and-integrating-the-rhacs-plugin-with-red-hat-developer-hub.adoc

@@ -12,4 +12,11 @@ By configuring and integrating the {rh-rhacs-first} plugin with {rh-rhdh-first},
 include::snippets/technology-preview.adoc[]
 
 //Viewing security information in {rh-rhdh}
-include::modules/viewing-security-information-in-red-hat-developer-hub.adoc[leveloffset=+1]
+include::modules/viewing-security-information-in-red-hat-developer-hub.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../configuration/configuring-and-integrating-the-rhacs-plugin-with-red-hat-developer-hub.adoc#rebuilding-the-oci-artifact_configuring-and-integrating-the-rhacs-plugin-with-red-hat-developer-hub[Rebuilding the OCI artifact]
+
+//Rebuilding the OCI artifact
+include::modules/rebuilding-the-oci-artifact.adoc[leveloffset=+1]

modules/common-attributes.adoc

@@ -61,6 +61,7 @@ endif::[]
 :rhacs-version: 4.7.2
 :ocp-supported-version: 4.12
 :ocp-latest-version: 4.17
+:plugin-acs-latest-version: 0.0.4
 :product-rosa: Red{nbsp}Hat OpenShift Service on AWS
 :product-rosa-short: ROSA
 :product-title: Red{nbsp}Hat Advanced Cluster Security for Kubernetes

modules/rebuilding-the-oci-artifact.adoc

@@ -0,0 +1,23 @@
+// Module included in the following assemblies:
+//
+// * configuration/configuring-and-integrating-the-rhacs-plugin-with-red-hat-developer-hub.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="rebuilding-the-oci-artifact_{context}"]
+= Rebuilding the OCI artifact
+
+To rebuild the Open Container Initiative (OCI) artifact, update the `repo-ref` field in the `source.json` file to reference the new commit ID of the plugin repository.
+
+.Procedure
+
+* To rebuild the OCI artifact, update the `repo-ref` field in the `source.json` file, for example:
++
+[IMPORTANT]
+====
+You can find the `source.json` file in the `workspaces/acs` directory of the `rhdh-plugin-export-overlays` repository.
+====
++
+[source,json]
+----
+{"repo":"https://github.com/backstage/community-plugins","repo-ref":"19ddb7837c6823a253c87af9524f8aef26a90b35","repo-flat":false}
+----

modules/viewing-security-information-in-red-hat-developer-hub.adoc

@@ -18,7 +18,7 @@ For more information, see link:https://docs.redhat.com/en/documentation/red_hat_
 
 .Procedure
 
-. Create an `app-config.yaml` file that contains the `proxy` and `acs` stanzas by using the following content:
+. In the `app-config.yaml` file, add the `proxy` and `acs` stanzas by using the following content:
 +
 [source,yaml]
 ----
@@ -38,19 +38,18 @@ acs:
 .. Navigate to the dynamic plugins configuration file in your {rh-rhdh} setup.
 .. To include the {product-title-short} plugin, add the following content to the configuration file, for example:
 +
-[source,yaml]
+[source,yaml,subs="attributes+"]
 ----
 # ...
-- package: https://github.com/RedHatInsights/backstage-plugin-advanced-cluster-security/releases/download/v0.1.1/redhatinsights-backstage-plugin-acs-dynamic-0.1.1.tgz
-  integrity: sha256-9JeRK2jN/Jgenf9kHwuvTvwTuVpqrRYsTGL6cpYAzn4=
+- package: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-acs:pr_986__{plugin-acs-latest-version}!backstage-community-plugin-acs"
   disabled: false
   pluginConfig:
     dynamicPlugins:
       frontend:
-        redhatinsights.backstage-plugin-acs:
+        backstage-community.plugin-acs:
           entityTabs:
             - path: /acs
-              title: RHACS
+              title: Security
               mountPoint: entity.page.acs
           mountPoints:
             - mountPoint: entity.page.acs/cards
@@ -100,4 +99,6 @@ metadata:
 
 . In the {rh-rhdh} portal, click *Catalog*.
 . Click an entity and verify that the *{product-title-short}* tab appears.
-. To view the violations and vulnerability data, click the *{product-title-short}* tab.
+. To view the violations and vulnerability data, click the *{product-title-short}* tab.
+
+After you configure and integrate the {product-title-short} plugin with {rh-rhdh}, you need to rebuild the Open Container Initiative (OCI) artifact. See "Rebuilding the OCI artifact" for instructions.