Skip to content

Conversation

@EMaksy
Copy link
Member

@EMaksy EMaksy commented Nov 28, 2025

Description

This pr updates the released documentation in the latest branch. I was following our our critical hotfix workflow https://www.trento-project.io/docs/developer/trento-docs-site/collaboration-docs-team/docs-git-workflow.html#_3_applying_a_critical_hotfix.
With this we have also a nice history in the commits :)
image

When we release Trento 3.0 we will follow this workflow
https://www.trento-project.io/docs/developer/trento-docs-site/collaboration-docs-team/docs-git-workflow.html#_2_publishing_a_new_release

Features

  • Added mcp docs images
  • Remove docker from user facing docs
  • Move updated docker mentions to dev docs
  • Update Trento support Plugin
  • Add docker deployment

EMaksy and others added 5 commits November 28, 2025 10:53
* Remove docker from user facing docks

* Remove container and docker mentions

* Remove SP3

* Add env for wanda

* Use vars and upcast rpm

* Add explicit sle 16.0
* Fix TRNT-3895

* Add feedback
* Add local docs build

* Fix selinux permission

* Add workflow guide
@EMaksy EMaksy self-assigned this Nov 28, 2025
* Restructure trento install section

* Remove partial as it was included in kubernetes partial

* Aligned naming of partial and added revdate to kubernetes
:trento: Trento

== Containerized deployment
=== Containerized deployment
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Container deployment was moved to developer docs, not to lose the information


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
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a link, to not fight with xref

@@ -0,0 +1,36 @@
== Local Documentation Preview with Docker
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This part is just developer docs for new way of preview antora with docker

:revdate: 2025-10-16


[[sec-trento-k8s-deployment]]
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved to trento-kubernetes-install.adoc[]

+
. Restart the application.

==== Enabling OpenID Connect when using Docker images
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Part of docker mention removal

+
. Restart the application.

[[enabling-oauth-20-when-using-docker-images]]
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Part of docker mention removal

+
. Restart the application.

==== Enabling SAML when using Docker images
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Part of docker mention removal

@EMaksy EMaksy marked this pull request as ready for review November 28, 2025 11:03
@EMaksy EMaksy requested review from abravosuse and dmpop November 28, 2025 11:03
[[sec-trento-install-trentoserver-on-existing-k8s-cluster]]
==== Installing {trserver} on an existing {k8s} cluster

{trserver} consists of a several components delivered as container images and intended for deployment on a {k8s} cluster. A manual production-ready deployment of these components requires {k8s} knowledge. Customers without in-house {k8s} expertise and who want to try {trento} with a minimum of effort, can use the {trento} Helm chart. This approach automates the deployment of all the required components on a single {k8s} cluster node. You can use the {trento} Helm chart to install {trserver} on a existing {k8s} cluster as follows:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{trserver} consists of a several components delivered as container images and intended for deployment on a {k8s} cluster. A manual production-ready deployment of these components requires {k8s} knowledge. Customers without in-house {k8s} expertise and who want to try {trento} with a minimum of effort, can use the {trento} Helm chart. This approach automates the deployment of all the required components on a single {k8s} cluster node. You can use the {trento} Helm chart to install {trserver} on a existing {k8s} cluster as follows:
{trserver} consists of a several components delivered as container images and intended for deployment on a {k8s} cluster. A manual production-ready deployment of these components requires {k8s} knowledge. Customers without in-house {k8s} expertise and those who want to try {trento} with a minimum of effort, can use the {trento} Helm chart. This approach automates the deployment of all the required components on a single {k8s} cluster node. You can use the {trento} Helm chart to install {trserver} on a existing {k8s} cluster as follows:

[[sec-trento-install-trentoserver-on-k3s]]
==== Installing {trserver} on K3s

If you do not have a {k8s} cluster, or have one but do not want to use it for {trento}, {suse} Rancher's K3s provides an alternative. To deploy {trserver} on K3s, you need a small server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you do not have a {k8s} cluster, or have one but do not want to use it for {trento}, {suse} Rancher's K3s provides an alternative. To deploy {trserver} on K3s, you need a small server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.
If you do not have a {k8s} cluster, or you have one but you do not want to use it for {trento}, you can use {suse} Rancher's K3s as an alternative. To deploy {trserver} on K3s, you need a server or VM (see <<sec-trento-server-requirements>> for minimum requirements) and follow steps in <<pro-trento-manually-installing>>.

Sender email for alert notifications

`ALERTING_RECIPIENT`::
Recipient email for alert notifications.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Recipient email for alert notifications.
Email address to receive alert notifications.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

3 participants