docs(konveyor): add the Alauda support for Konveyor installation guide - #821
Merged
Conversation
The certified "Alauda support for Konveyor" package is going GA, and its marketplace Overview links to solutions/ecosystem/konveyor/Konveyor_Installation_Guide.html, which did not exist. This adds it, following the Knative/Nacos/OpenSearch guide convention. The guide leads with storage planning, because that is what actually blocks installs: the platform asks for two ReadWriteOnce volumes, and hand-written YAML that omits the size fields inherits an upstream default of 100Gi for the file store, which many clusters cannot bind. The console form is prefilled with smaller tested values (5Gi / 10Gi) and the guide says so explicitly. Known limitations are stated rather than left to be discovered: authentication and the AI-assisted migration feature cannot be enabled in this release (their images are published for amd64 only and are not shipped), ui_ingress_class_name defaults to a class many clusters do not run, and there is no upgrade path from the older community konveyor-operator catalog entry. The existing How_to_Use_Konveyor.md described that older entry and actively contradicted the certified package -- it recommends feature_auth_required: true, rwx_supported: true and a 100Gi bucket. Rather than rewrite content that is still correct for its own audience, it now states which package it applies to, and carries warnings at the two places that would break someone following it on the certified package (the Tackle example and the KAI section), each pointing at the new guide. en only: the zh mirrors are produced by the translation pipeline from the en sources (tracked via sourceSHA) and should not be committed by hand. No id: in the new file's frontmatter either -- add_id.sh allocates it from the CRM by title on merge to main, and skips files that already have one.
SuJinpei
force-pushed
the
docs/konveyor-installation-guide
branch
from
July 29, 2026 03:08
bc4685d to
8d75929
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The certified Alauda support for Konveyor package is going GA, and its marketplace Overview links
to
solutions/ecosystem/konveyor/Konveyor_Installation_Guide.html— which did not exist. This addsit, following the Knative / Nacos / OpenSearch guide convention.
New:
ecosystem/konveyor/Konveyor_Installation_Guide.mdThe guide leads with storage planning, because that is what actually blocks installs. The
platform asks for two ReadWriteOnce volumes; hand-written YAML that omits the size fields inherits an
upstream default of 100Gi for the file store, which many clusters cannot bind. The console form
is prefilled with smaller tested values (5Gi / 10Gi) and the guide says so explicitly rather than
leaving the discrepancy to be discovered.
Known limitations are stated up front:
feature_auth_requiredmust stayfalse) —the Keycloak images it needs are published for amd64 only and are not shipped with the package.
ui_ingress_class_namedefaults tonginx, which many clusters do not run.konveyor-operatorcatalog entry (0.6.0-beta.1) —this is a separate, newly published package.
Uses the
factory:auto:*marker convention so later releases regenerate only the version andlimitation slots, leaving the prose human-owned.
Corrected:
How_to_Use_Konveyor.mdThat page describes the older community entry and actively contradicts the certified package — it
recommends
feature_auth_required: true,rwx_supported: trueand a 100Gi bucket. Rather thanrewrite content that is still correct for its own audience, it now states which package it applies
to, and carries warnings at the two places that would break someone following it on the certified
package (the
Tackleexample and the KAI section), each pointing at the new guide.Conventions followed
via
sourceSHA) and are not committed by hand.id:in the new file's frontmatter —add_id.shallocates it from the CRM by H1 title onmerge to
main, and skips any file that already has one.