Update current release

trento/adoc/trento-container-install.adoc → content/internal-notes/trento-container-install.adoc

@@ -1,19 +1,18 @@
-include::product-attributes.adoc[]
+:trento: Trento
 
-== Containerized deployment
+=== Containerized deployment
 :revdate: 2025-08-05
 
-
-A containerized deployment of {trserver} is identical to the systemd
+A containerized deployment of {trento} is identical to the systemd
 deployment. However, the web and check engine components are deployed as
 Docker containers.
 
-Follow the steps in <<sec-systemd-deployment>>, but skip the *Install
-Trento using RPM packages* step and follow the procedures as described below.
+Follow the steps in link:https://www.trento-project.io/docs/user-guide/trento-install-server.html#sec-systemd-deployment[systemd installation], but skip the *Install
+{trento} using RPM packages* step and follow the procedures as described below.
 
-=== Install Trento using Docker
+==== Install Trento using Docker
 
-==== Install Docker container runtime
+===== Install Docker container runtime
 
 . Enable the containers module (replace `15.x` with the correct Service Pack version):
 +
@@ -35,9 +34,9 @@ zypper install docker
 systemctl enable --now docker
 ----
 
-==== Create a dedicated Docker network for Trento
+==== Create a dedicated Docker network for {trento}
 
-. Create the Trento Docker network:
+. Create the {trento} Docker network:
 +
 [source,bash]
 ----
@@ -61,7 +60,7 @@ The output should be similar to this (the exact address may vary):
 . Open the _/var/lib/pgsql/data/pg_hba.conf_ file for editing and replace `0.0.0.0/0` with the address returned by the command in the previous step.
 . Restart the PostgreSQL server using the `systemctl restart postgresql` command.
 
-==== Install Trento on Docker
+==== Install {trento} on Docker
 
 . Create secret environment variables:
 +
@@ -104,6 +103,8 @@ docker run -d --name wanda \
     -e ACCESS_TOKEN_ENC_SECRET=$ACCESS_TOKEN_ENC_SECRET \
     -e AMQP_URL=amqp://trento_user:[email protected]/vhost \
     -e DATABASE_URL=ecto://wanda_user:[email protected]/wanda \
+    -e OAS_SERVER_URL=https://trento.example.com/wanda \
+    -e AUTH_SERVER_URL=http://localhost:4000 \
     --restart always \
     --entrypoint /bin/sh \
     registry.suse.com/trento/trento-wanda:latest \
@@ -121,7 +122,7 @@ the UI.
 [NOTE]
 ====
 Add `+CHARTS_ENABLED=false+` if Prometheus is not installed, or you do
-not want to use Trento's charts functionality.
+not want to use {trento}'s charts functionality.
 ====
 +
 [source,bash]

content/trento-docs-site/preview-docs-with-docker.adoc

@@ -0,0 +1,36 @@
+== Local Documentation Preview with Docker
+
+Easy way to locally preview documentation changes without installing repository dependencies (like Node.js or Antora) on your host machine.
+
+=== Prerequisites
+
+* Docker Engine (or Podman).
+* Docker Compose.
+
+=== Workflow
+
+. **Start the Preview**
++
+To start the build process inside a container, navigate to the root directory of the repository and run the following command:
++
+[source,bash]
+----
+docker compose up
+----
++
+
+. **Check the Docs**
++
+Once the build is complete and the server starts, open your browser and navigate to:
++
+http://localhost:3000
+
+. **Review and Rebuild**
++
+The container builds the site and serves it. To view new changes:
++
+* Stop the container (press `Ctrl+C`).
+* Make your changes to the source files.
+* Run `docker compose up` again.
++
+The container will rebuild the documentation with your new changes for preview.

docker-compose.yml

@@ -0,0 +1,18 @@
+services:
+  trento-docs:
+    image: node:20-bullseye
+    volumes:
+      - .:/workspace:z
+      - trento-docs-node_modules:/workspace/trento-docs-site/node_modules
+    working_dir: /workspace/trento-docs-site
+    command: >
+      bash -lc "
+        npm install --no-save antora http-server &&
+        npx antora antora-playbook.yml &&
+        npx http-server build/trento-docs-site-public/ -c-1 -p 3000
+      "
+    ports:
+      - "3000:3000"
+
+volumes:
+  trento-docs-node_modules:

trento-docs-site/antora.yml

@@ -107,6 +107,9 @@ ext:
       - dir: trento-docs-site/build/tmp_components/mcp-server/docs
         files: ['**/*.adoc', '!README.adoc']
         into: modules/mcp-server/pages
+      - dir: trento-docs-site/build/tmp_components/mcp-server/docs/images
+        files: '**/*.{png,jpg,jpeg,svg,gif}'
+        into: modules/mcp-server/images/
     ## Trento Photofinish https://github.com/trento-project/photofinish
     - scan:
       - dir: trento-docs-site/build/tmp_components/photofinish

trento-docs-site/modules/developer/nav_developer.adoc

@@ -35,9 +35,11 @@
 ** Internal Notes
 *** xref:internal-notes/pr-env-ssl-certificate-setup.adoc[SSL Certificate creation and setup Guide for Pull Request Environments]
 *** xref:internal-notes/release.adoc[Release Process]
+*** xref:internal-notes/trento-container-install.adoc[Containerized deployment]
 
 ** Trento Documentation Page
 *** xref:trento-docs-site/README.adoc[Documentation Page]
+*** xref:trento-docs-site/preview-docs-with-docker.adoc[Local Documentation Preview with Docker]
 *** xref:trento-docs-site/contribution-upstream/components-nav-guide.adoc[Component Documentation Navigation Guide]
 *** xref:trento-docs-site/collaboration-docs-team/docs-git-workflow.adoc[Git Workflow for Trento Documentation]
 *** xref:trento-docs-site-ui/README.adoc[Documentation Page UI]

trento/adoc/trento-activity-log.adoc

@@ -11,7 +11,7 @@ console.
 
 Each entry in the Activity Log includes the following:
 
-* A timestamp: the day and time (server time, not browser time) the
+* A timestamp: the day and time (UTC timezone) the
 system event or the user action occurred
 * A message: type of the occurred event or user action
 * The user that triggered the event or performed the action. User system
@@ -32,7 +32,7 @@ The Activity Log allows you to filter by the type of event or user action
 (commonly referred to as resource type), by the user that triggered the event or
 performed the action, and by severity status. Only active users are available
 for filtering. The Activity Log also allows you to filter out entries that are
-newer and/or older than an specific date and time (server time).
+newer and/or older than an specific date and time (UTC timezone).
 
 Once a filter has been set, click Apply to filter out the undesired
 entries and Reset to remove all the filters.
@@ -66,4 +66,4 @@ The default retention time for entries in the Activity Log is one month.
 This can be changed in the Activity Log section under Settings. Changing
 the retention time requires the `+all:settings+` permissions. Entries
 older than the specified retention time are deleted every day at
-midnight (server time).
+midnight (UTC timezone).