Skip to content

MTA-6439 Documentation of Dockerfile Not Generated by generate helm#312

Open
Pkylas007 wants to merge 8 commits intomainfrom
mta-6439-helm-structure-values-k8s-non-k8s
Open

MTA-6439 Documentation of Dockerfile Not Generated by generate helm#312
Pkylas007 wants to merge 8 commits intomainfrom
mta-6439-helm-structure-values-k8s-non-k8s

Conversation

@Pkylas007
Copy link
Copy Markdown
Collaborator

@Pkylas007 Pkylas007 commented Feb 16, 2026

JIRA

Version

  • 8.1.0

Preview

Summary by CodeRabbit

  • Documentation
    • Added a visual Helm chart exploration and clarified where chart templates and artifact files belong.
    • Included an inlined discovery manifest example and guidance on configuring buildpacks for assets.
    • Updated generation flow to accept a discovery manifest, clarified output locations, and separated Dockerfile verification into its own step.
    • Expanded live-discovery procedure with prerequisites, detailed command examples, and config file copy guidance.
    • Added a link to the Cloud Foundry manifest schema.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Feb 16, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Documentation updates: expanded Helm-chart inspection and discovery-manifest examples, revised generation command flow and verification (separate ConfigMap and Dockerfile checks), added CF manifest schema link, and extended live-discovery procedure with example commands and optional CF config usage.

Changes

Cohort / File(s) Summary
Helm chart manifest generation doc
docs/topics/mta-cli/proc_generating-deployment-manifest.adoc
Added Helm chart tree and exact template locations (templates/configmap.yaml, templates/files/konveyor/Dockerfile, values.yaml); clarified where to place Kubernetes YAML vs text templates; inlined a discovery manifest example (including buildPacks and env); updated generation command to accept an input discovery manifest and explicit output location; split verification into ConfigMap and Dockerfile inspection; added CloudFoundry app manifest schema link.
Live discovery doc
docs/topics/mta-cli/proc_performing-a-live-discovery.adoc
Expanded Procedure and Prerequisites with optional investigation subsection; added step to copy CF config and example commands demonstrating --output-dir and --cf-config; wrapped command snippets with [subs="+quotes"] and reorganized verification/example steps.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐇 I hopped through charts and manifest rows,
Found Dockerfiles where nobody knows,
ConfigMaps hummed a tidy tune,
Buildpacks twirled beneath the moon,
I nibbled notes — the docs now glow!

🚥 Pre-merge checks | ✅ 3 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Merge Conflict Detection ⚠️ Warning ❌ Merge conflicts detected (58 files):

⚔️ assemblies/ui-guide/assembly_analyzing-applications.adoc (content)
⚔️ assemblies/ui-guide/assembly_assessing-applications.adoc (content)
⚔️ assemblies/ui-guide/assembly_assessment-questionnaires.adoc (content)
⚔️ assemblies/ui-guide/assembly_configuring-credentials.adoc (content)
⚔️ assemblies/ui-guide/assembly_configuring-mta-instance-environment.adoc (content)
⚔️ assemblies/ui-guide/assembly_configuring-mta-instance.adoc (content)
⚔️ assemblies/ui-guide/assembly_configuring-repositories.adoc (content)
⚔️ assemblies/ui-guide/assembly_controlling-tasks-with-task-manager.adoc (content)
⚔️ assemblies/ui-guide/assembly_creating-and-configuring-a-jira-connection.adoc (content)
⚔️ assemblies/ui-guide/assembly_managing-applications.adoc (content)
⚔️ assemblies/ui-guide/assembly_mta-custom-questionnaire.adoc (content)
⚔️ assemblies/ui-guide/assembly_tagging-applications.adoc (content)
⚔️ assemblies/ui-guide/assembly_working-with-archetypes.adoc (content)
⚔️ docs/topics/mta-cli/proc_generating-deployment-manifest.adoc (content)
⚔️ docs/topics/mta-cli/proc_performing-a-live-discovery.adoc (content)
⚔️ docs/topics/mta-ui/con_assessment-module-features.adoc (content)
⚔️ docs/topics/mta-ui/con_intro-to-mta-ui.adoc (content)
⚔️ docs/topics/mta-ui/con_mta-default-questionnaire.adoc (content)
⚔️ docs/topics/mta-ui/proc_accessing-analysis-insights.adoc (content)
⚔️ docs/topics/mta-ui/proc_accessing-unmatched-rules.adoc (content)
⚔️ docs/topics/mta-ui/proc_adding-applications.adoc (content)
⚔️ docs/topics/mta-ui/proc_assessing-an-application.adoc (content)
⚔️ docs/topics/mta-ui/proc_assessing-an-archetype.adoc (content)
⚔️ docs/topics/mta-ui/proc_assigning-application-credentials.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-and-running-an-application-analysis.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-git-repos.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-jira-credentials.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-maven-credentials.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-maven-repo.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-proxy-credentials.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-proxy-settings.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-source-control-credentials.adoc (content)
⚔️ docs/topics/mta-ui/proc_configuring-subversion-repos.adoc (content)
⚔️ docs/topics/mta-ui/proc_controlling-task-order-with-task-manager.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-a-business-service.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-a-jira-connection.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-a-stakeholder.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-a-tag.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-application-tags.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-custom-migration-targets.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-jira-issues-for-migration-wave.adoc (content)
⚔️ docs/topics/mta-ui/proc_creating-migration-waves.adoc (content)
⚔️ docs/topics/mta-ui/proc_defining-an-archetype.adoc (content)
⚔️ docs/topics/mta-ui/proc_displaying-automated-tasks.adoc (content)
⚔️ docs/topics/mta-ui/proc_displaying-the-tags-of-an-application.adoc (content)
⚔️ docs/topics/mta-ui/proc_downloading-an-analysis-report.adoc (content)
⚔️ docs/topics/mta-ui/proc_importing-an-app-list.adoc (content)
⚔️ docs/topics/mta-ui/proc_managing-mta-questionnaires.adoc (content)
⚔️ docs/topics/mta-ui/proc_manual-tagging-of-an-application.adoc (content)
⚔️ docs/topics/mta-ui/proc_reviewing-a-task-log.adoc (content)
⚔️ docs/topics/mta-ui/proc_reviewing-an-analysis-report.adoc (content)
⚔️ docs/topics/mta-ui/proc_reviewing-an-application.adoc (content)
⚔️ docs/topics/mta-ui/proc_reviewing-an-archetype.adoc (content)
⚔️ docs/topics/mta-ui/proc_reviewing-assessment-report.adoc (content)
⚔️ docs/topics/mta-ui/proc_setting-default-credentials.adoc (content)
⚔️ docs/topics/mta-ui/ref_custom-questionnaire-fields.adoc (content)
⚔️ docs/topics/mta-ui/ref_yaml-template-for-custom-questionnaire.adoc (content)
⚔️ docs/web-console-guide/master.adoc (content)

These conflicts must be resolved before merging into main.
Resolve conflicts locally and push changes to this branch.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title references the specific issue (MTA-6439) and directly describes the main problem being addressed: Dockerfiles not being generated by the generate helm command, which aligns with the documentation changes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch mta-6439-helm-structure-values-k8s-non-k8s

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/topics/mta-cli/proc_generating-deployment-manifest.adoc (1)

50-64: ⚠️ Potential issue | 🟠 Major

CLI commands look incorrect and steps are redundant.
mta-cli cd doesn’t appear to be a valid command; this should likely be a plain cd. Also, cat Dockerfile appears in both “Verify the ConfigMap” and “Verify the Dockerfile,” which is confusing.

✅ Suggested edit
-. Verify the ConfigMap:
+. Verify the ConfigMap:
 +
 [subs="+quotes"]
 ----
-$ *mta-cli cd _<location_of_deployment_manifest>_ \*
+$ *cd _<location_of_deployment_manifest>_*
 $ *cat configmap.yaml*
-$ *cat Dockerfile*
 ----
 . Verify the Dockerfile:
 +
 [subs="+quotes"]
 ----
-$ *mta-cli cd _<location_of_deployment_manifest>_ \*
+$ *cd _<location_of_deployment_manifest>_*
 $ *cat Dockerfile*
 ----
🤖 Fix all issues with AI agents
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 39: Fix the typos and AsciiDoc markup in the sentence that references the
Helm chart templates: change “diretory” to “directory” and replace the angled
markup `<_files/konveyor_>` with the plain AsciiDoc-friendly `_files/konveyor_`
so the sentence reads correctly when rendered (look for the string "templates
directory" and the fragments `diretory` and `<_files/konveyor_>` to locate the
exact text to update).

@Pkylas007
Copy link
Copy Markdown
Collaborator Author

@gciavarrini Please could you look through this PR and suggest which manifests must be added?

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
docs/topics/mta-cli/proc_generating-deployment-manifest.adoc (2)

111-111: ⚠️ Potential issue | 🟠 Major

Fix incorrect command syntax.

Same issue as in the ConfigMap verification step: mta-cli cd is invalid. Use the shell cd command and remove the trailing \*.

🔧 Proposed fix
-$ *mta-cli cd _<location_of_deployment_manifest>_ \*
+$ *cd _<location_of_deployment_manifest>_*
 $ *cat Dockerfile*
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc` at line 111,
Replace the invalid shell command string "*mta-cli cd
_<location_of_deployment_manifest>_ \\*" with a proper shell invocation: use the
standard cd command (cd _<location_of_deployment_manifest>_) and remove the
surrounding asterisks and the trailing "\*" so the documentation shows a valid
shell prompt example; update the line containing the literal shown command to
the cleaned "cd _<location_of_deployment_manifest>_" form.

95-98: ⚠️ Potential issue | 🟡 Minor

Remove extraneous formatting characters.

The \* on line 98 appears to be a formatting error. The code block should close cleanly after the line continuation on line 97.

📝 Proposed fix
 $ *mta-cli generate helm --chart-dir helm_sample \
 --input _<path_to_discovery-manifest>_ \
---output-dir _<location_of_deployment_manifest>_ \*
+--output-dir _<location_of_deployment_manifest>_*
 ----
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc` around lines 95
- 98, Remove the stray formatting characters `\*` that follow the command in the
code block; locate the line starting with "$ *mta-cli generate helm --chart-dir
helm_sample \\" (the command invocation) and delete the trailing `\*` so the
code block closes cleanly after the line continuation, leaving only the intended
command and backslash.
🧹 Nitpick comments (1)
docs/topics/mta-cli/proc_generating-deployment-manifest.adoc (1)

47-47: Use consistent file naming.

For clarity and consistency with the rest of the documentation, use the full filename values.yaml instead of just values.

📝 Proposed fix
-You generate the discovery manifest before generating the deployment manifest. In the deployment manifest, the values in the `values.yaml` file override the values in the discovery manifest. If the `values` file is empty, {ProductShortName} considers the discovery manifest configuration as input to generate the deployment manifest.
+You generate the discovery manifest before generating the deployment manifest. In the deployment manifest, the values in the `values.yaml` file override the values in the discovery manifest. If the `values.yaml` file is empty, {ProductShortName} considers the discovery manifest configuration as input to generate the deployment manifest.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc` at line 47,
Update the sentence in the "proc_generating-deployment-manifest.adoc" text so it
consistently uses the full filename `values.yaml` instead of the short form
`values`; specifically change the phrase "the values file" (and any other
occurrences of "values" referring to the file) to "the `values.yaml` file" in
the paragraph discussing how the deployment manifest overrides the discovery
manifest so it matches the rest of the docs.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 45: Remove the extraneous comma that follows the closing parenthesis in
the sentence describing where to save text-based templates; update the line that
mentions "text-based templates (for example, `Dockerfile`), in the
_files/konveyor_ path in the `templates` directory." to eliminate the comma
after the parenthesis so it reads smoothly (keep references to `YAML`,
`ConfigMap`, `Deployment`, `templates` directory, and `_files/konveyor` path
intact).
- Line 104: Replace the invalid snippet "$ *mta-cli cd
_<location_of_config_map>_ \*" by using the shell cd command and removing the
stray backslash-asterisk: change the text that contains "mta-cli cd" to instruct
the reader to run "cd <location_of_config_map>" (no "mta-cli" prefix and remove
the trailing "\*") so the command is a valid shell directory change.

---

Outside diff comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 111: Replace the invalid shell command string "*mta-cli cd
_<location_of_deployment_manifest>_ \\*" with a proper shell invocation: use the
standard cd command (cd _<location_of_deployment_manifest>_) and remove the
surrounding asterisks and the trailing "\*" so the documentation shows a valid
shell prompt example; update the line containing the literal shown command to
the cleaned "cd _<location_of_deployment_manifest>_" form.
- Around line 95-98: Remove the stray formatting characters `\*` that follow the
command in the code block; locate the line starting with "$ *mta-cli generate
helm --chart-dir helm_sample \\" (the command invocation) and delete the
trailing `\*` so the code block closes cleanly after the line continuation,
leaving only the intended command and backslash.

---

Nitpick comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 47: Update the sentence in the "proc_generating-deployment-manifest.adoc"
text so it consistently uses the full filename `values.yaml` instead of the
short form `values`; specifically change the phrase "the values file" (and any
other occurrences of "values" referring to the file) to "the `values.yaml` file"
in the paragraph discussing how the deployment manifest overrides the discovery
manifest so it matches the rest of the docs.

@Pkylas007 Pkylas007 force-pushed the mta-6439-helm-structure-values-k8s-non-k8s branch from 2abd907 to 6e3e760 Compare February 17, 2026 06:25
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/topics/mta-cli/proc_generating-deployment-manifest.adoc (1)

95-98: ⚠️ Potential issue | 🟡 Minor

Fix the trailing markup on the command.

Line 97 ends with \* but there's no continuation line. The backslash should be removed, leaving only the closing bold marker *.

📝 Proposed fix
 $ *mta-cli generate helm --chart-dir helm_sample \
 --input _<path_to_discovery-manifest>_ \
---output-dir _<location_of_deployment_manifest>_ \*
+--output-dir _<location_of_deployment_manifest>_*
 ----
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc` around lines 95
- 98, The trailing backslash before the closing bold marker in the command
snippet "mta-cli generate helm --chart-dir helm_sample --input
_<path_to_discovery-manifest>_ --output-dir _<location_of_deployment_manifest>_"
is incorrect; remove the backslash so the line ends with a single asterisk (*)
to close the bold markup (i.e., replace `\*` with `*`) ensuring proper AsciiDoc
bold formatting.
🧹 Nitpick comments (1)
docs/topics/mta-cli/proc_generating-deployment-manifest.adoc (1)

89-89: Consider clarifying the buildpack configuration note.

The phrase "in the Cloud Foundry application manifest" might be ambiguous in this context. Consider specifying "source Cloud Foundry application manifest" or rephrasing for clarity.

✏️ Alternative phrasing
-NOTE: You must configure the buildpacks in the Cloud Foundry application manifest to include the buildpacks in the discovery and deployment assets.
+NOTE: Buildpacks are included in the discovery and deployment assets only if they are configured in the source Cloud Foundry application manifest.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc` at line 89, The
NOTE's wording is ambiguous; update the sentence "NOTE: You must configure the
buildpacks in the Cloud Foundry application manifest to include the buildpacks
in the discovery and deployment assets." to explicitly reference the source
manifest (for example: "NOTE: You must configure the buildpacks in the source
Cloud Foundry application manifest to include the buildpacks in the discovery
and deployment assets."), or rephrase similarly to remove ambiguity about which
manifest is meant.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 111: Remove the erroneous escape sequence at the end of the bolded cd
example: find the line containing "$ *cd _<location_of_deployment_manifest>_ \*"
and delete the backslash so the trailing "\*" becomes the closing bold marker
"*" resulting in "$ *cd _<location_of_deployment_manifest>_*".

---

Outside diff comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Around line 95-98: The trailing backslash before the closing bold marker in
the command snippet "mta-cli generate helm --chart-dir helm_sample --input
_<path_to_discovery-manifest>_ --output-dir _<location_of_deployment_manifest>_"
is incorrect; remove the backslash so the line ends with a single asterisk (*)
to close the bold markup (i.e., replace `\*` with `*`) ensuring proper AsciiDoc
bold formatting.

---

Duplicate comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 45: There's an extraneous comma after the closing parenthesis in the
sentence that starts "You must save text-based templates (for example,
`Dockerfile`), in the _files/konveyor_ path..." — remove that comma so it reads
"...`Dockerfile`) in the _files/konveyor_ path..." (edit the line containing the
phrase "text-based templates (for example, `Dockerfile`), in the
_files/konveyor_ path" to delete the comma and ensure spacing stays correct).
- Line 104: Remove the stray escape before the closing bold marker in the line
containing "$ *cd _<location_of_config_map>_ \*": delete the backslash so the
closing asterisk remains unescaped (resulting in "$ *cd
_<location_of_config_map>_*"), ensuring the bold markup is properly closed.

---

Nitpick comments:
In `@docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`:
- Line 89: The NOTE's wording is ambiguous; update the sentence "NOTE: You must
configure the buildpacks in the Cloud Foundry application manifest to include
the buildpacks in the discovery and deployment assets." to explicitly reference
the source manifest (for example: "NOTE: You must configure the buildpacks in
the source Cloud Foundry application manifest to include the buildpacks in the
discovery and deployment assets."), or rephrase similarly to remove ambiguity
about which manifest is meant.

└── values.yaml
----
+
You must save the Kubernetes `YAML` templates (for example, `ConfigMap` or `Deployment`) in the `templates` directory present in the root directory of the `Helm` chart. You must save text-based templates (for example, `Dockerfile`) in the _files/konveyor_ path in the `templates` directory.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I would says something like "Save non-Kubernetes templates (such as Dockerfile or configuration files) in the files/konveyor/ at the root of your Helm chart.".

  • I feel text-based files it's inaccurate
  • Please note that files/konveyor/ must be located in the root folder, not inside template folder.

Copy link
Copy Markdown
Collaborator Author

@Pkylas007 Pkylas007 Feb 17, 2026

Choose a reason for hiding this comment

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

But the /files/konveyor dir structure within the templates folder also works? I was wondering if the structure is a very strict requirement.

I verified the Dockerfile description in the Docker documentation. Could you check again, please?

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

nope it's in the root. See https://github.com/konveyor/asset-generation/tree/main/pkg/providers/generators/helm/test_data/mixed_templates/files/konveyor (where mixed_templates is the root).

And, as proof (i don't think we need to mention in the doc), that path is hardcoded in the generate library https://github.com/konveyor/asset-generation/blob/e9891d2466a276a4f9d4957bbe1e0d3c8f942d39/pkg/providers/generators/helm/provider.go#L16

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I was wondering if the structure is a very strict requirement.

yes it is

I verified the Dockerfile description in the Docker documentation. Could you check again, please?

can you clarify this? I don't understand what is your doubt about the Dockerfile

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

ah, the helm chart directory structure is what the JIRA asks me to document. Sorry but I need to include it because of the requirement in the ticket.

The Docker website describes Dockerfile as: "A Dockerfile is a text-based document that's used to..."

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The Docker website describes Dockerfile as: "A Dockerfile is a text-based document that's used to..."

That's absolutely true, and you're the expert on how to write documentation! 😊
I'm just sharing my technical perspective, but you definitely know what works best for the users.

Copy link
Copy Markdown
Collaborator Author

@Pkylas007 Pkylas007 Feb 18, 2026

Choose a reason for hiding this comment

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

Thanks for your feedback 😄 They're really helpful!

+
You must save the Kubernetes `YAML` templates (for example, `ConfigMap` or `Deployment`) in the `templates` directory present in the root directory of the `Helm` chart. You must save text-based templates (for example, `Dockerfile`) in the _files/konveyor_ path in the `templates` directory.
+
When you generate generate the deployment manifest after generating the discovery manifest, the values in the `values.yaml` file override the values in the discovery manifest. If the `values` file is empty, {ProductShortName} considers the discovery manifest configuration as input to generate the deployment manifest.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

  • There is a typo When you generate generate.
  • I suggest rewording a bit the initial because it's a bit unclear. Maybe "When generating deployment manifests from the discovery manifest, "
  • If the values file is empty or missing
  • Not sure about this "considers the discovery manifest configuration": is it correct to use configuration? I think it isn't clear that the generation uses discovery manifest values directly. WDYT?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Yup, will make the changes. Thanks!

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Hello @gciavarrini !

  • Took care of the typo
  • Reworded for better clarity
  • Added the word missing to describe the values.yaml file scenarios
  • Removed the configuration.

Could you take a quick look at the changes, please?

+
When you generate generate the deployment manifest after generating the discovery manifest, the values in the `values.yaml` file override the values in the discovery manifest. If the `values` file is empty, {ProductShortName} considers the discovery manifest configuration as input to generate the deployment manifest.

. Explore the discovery manifest configuration:
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

same doubt about "configuration"

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Got it 👍 Removed configuration in this sentence.

+
[subs="+quotes"]
----
manifest:
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

not sure i get the intent here.
Do you want to show an example of the generate command output?

Copy link
Copy Markdown
Collaborator Author

@Pkylas007 Pkylas007 Feb 17, 2026

Choose a reason for hiding this comment

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

The JIRA asks for a template of the Dockerfile so that developers can create templates that can capture these values.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

ahhhh ok, maybe it's better to clarify that you're providing an example for that scenario.

I'll try to explain the big picture.

The generate command needs as input a discovery manifest.
Let's say that the discovery.yaml looks like

appName: my-nodejs-app
database:
  enabled: true
  host: postgres.example.com

Example 1: no values.yaml
you have a Dockerfile template like

FROM node:18

ENV APP_NAME={{ .Values.appName }}
{{- if .Values.database.enabled }}
ENV DATABASE_HOST={{ .Values.database.host }}
{{- end }}

The generate command will render it to

FROM node:18

ENV APP_NAME=my-nodejs-app
ENV DATABASE_HOST=postgres.example.com

Example 2: with values.yaml
you have a Dockerfile template like:

FROM node:18

ENV APP_NAME={{ .Values.appName }}
{{- if .Values.database.enabled }}
ENV DATABASE_HOST={{ .Values.database.host }}
{{- end }}
{{- if .Values.redis }}
ENV REDIS_URL={{ .Values.redis.url }}
{{- end }}

note that .Values.redis.url isn't available in the discovery manifest.

You also have this values.yaml file:

appName: my-nodejs-app-production  # Override discovery value
  database:
    host: prod-postgres.company.com   # Override discovery value
  redis:                             # Add new field not in discovery
    url: redis://prod-redis:6379

The generate command will render it to:

  FROM node:18

  ENV APP_NAME=my-nodejs-app-production
  ENV DATABASE_HOST=prod-postgres.company.com
  ENV REDIS_URL=redis://prod-redis:6379

Does this help? Please let me know if there is any unclear part :)

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Thanks very much! I documented these examples in a reference file added to this PR (because doc conventions). Could you take a look, please?

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I really like the new structure! The example now it's much more clear in my opinion: well done 👏🏻

Copy link
Copy Markdown
Collaborator Author

@Pkylas007 Pkylas007 Feb 19, 2026

Choose a reason for hiding this comment

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

Well, thanks to @mpershina for helping me with the structural suggestions 😁

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Feb 18, 2026

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
{"name":"HttpError","status":500,"request":{"method":"PATCH","url":"https://api.github.com/repos/migtools/mta-documentation/issues/comments/3906908563","headers":{"accept":"application/vnd.github.v3+json","user-agent":"octokit.js/0.0.0-development octokit-core.js/7.0.6 Node.js/24","authorization":"token [REDACTED]","content-type":"application/json; charset=utf-8"},"body":{"body":"<!-- This is an auto-generated comment: summarize by coderabbit.ai -->\n<!-- This is an auto-generated comment: review paused by coderabbit.ai -->\n\n> [!NOTE]\n> ## Reviews paused\n> \n> It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the `reviews.auto_review.auto_pause_after_reviewed_commits` setting.\n> \n> Use the following commands to manage reviews:\n> - `@coderabbitai resume` to resume automatic reviews.\n> - `@coderabbitai review` to trigger a single review.\n> \n> Use the checkboxes below for quick actions:\n> - [ ] <!-- {\"checkboxId\": \"7f6cc2e2-2e4e-497a-8c31-c9e4573e93d1\"} --> ▶️ Resume reviews\n> - [ ] <!-- {\"checkboxId\": \"e9bb8d72-00e8-4f67-9cb2-caf3b22574fe\"} --> 🔍 Trigger review\n\n<!-- end of auto-generated comment: review paused by coderabbit.ai -->\n<!-- walkthrough_start -->\n\n<details>\n<summary>📝 Walkthrough</summary>\n\n## Walkthrough\n\nDocumentation updates: expanded Helm-chart inspection and discovery-manifest examples, revised generation command flow and verification (separate ConfigMap and Dockerfile checks), added CF manifest schema link, and extended live-discovery procedure with example commands and optional CF config usage.\n\n## Changes\n\n|Cohort / File(s)|Summary|\n|---|---|\n|**Helm chart manifest generation doc** <br> `docs/topics/mta-cli/proc_generating-deployment-manifest.adoc`|Added Helm chart tree and exact template locations (`templates/configmap.yaml`, `templates/files/konveyor/Dockerfile`, `values.yaml`); clarified where to place Kubernetes YAML vs text templates; inlined a discovery manifest example (including `buildPacks` and `env`); updated generation command to accept an input discovery manifest and explicit output location; split verification into ConfigMap and Dockerfile inspection; added CloudFoundry app manifest schema link.|\n|**Live discovery doc** <br> `docs/topics/mta-cli/proc_performing-a-live-discovery.adoc`|Expanded Procedure and Prerequisites with optional investigation subsection; added step to copy CF config and example commands demonstrating `--output-dir` and `--cf-config`; wrapped command snippets with `[subs=\"+quotes\"]` and reorganized verification/example steps.|\n\n## Estimated code review effort\n\n🎯 3 (Moderate) | ⏱️ ~25 minutes\n\n## Poem\n\n> 🐇 I hopped through charts and manifest rows,  \n> Found Dockerfiles where nobody knows,  \n> ConfigMaps hummed a tidy tune,  \n> Buildpacks twirled beneath the moon,  \n> I nibbled notes — the docs now glow!\n\n</details>\n\n<!-- walkthrough_end -->\n\n\n<!-- pre_merge_checks_walkthrough_start -->\n\n<details>\n<summary>🚥 Pre-merge checks | ✅ 3 | ❌ 1</summary>\n\n### ❌ Failed checks (1 warning)\n\n|        Check name        | Status     | Explanation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Resolution                                                 |\n| :----------------------: | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------- |\n| Merge Conflict Detection | ⚠️ Warning | ❌ Merge conflicts detected (58 files):<br><br>  ⚔️ `assemblies/ui-guide/assembly_analyzing-applications.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_assessing-applications.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_assessment-questionnaires.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_configuring-credentials.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_configuring-mta-instance-environment.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_configuring-mta-instance.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_configuring-repositories.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_controlling-tasks-with-task-manager.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_creating-and-configuring-a-jira-connection.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_managing-applications.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_mta-custom-questionnaire.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_tagging-applications.adoc` (content)<br>  ⚔️ `assemblies/ui-guide/assembly_working-with-archetypes.adoc` (content)<br>  ⚔️ `docs/topics/mta-cli/proc_generating-deployment-manifest.adoc` (content)<br>  ⚔️ `docs/topics/mta-cli/proc_performing-a-live-discovery.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/con_assessment-module-features.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/con_intro-to-mta-ui.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/con_mta-default-questionnaire.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_accessing-analysis-insights.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_accessing-unmatched-rules.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_adding-applications.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_assessing-an-application.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_assessing-an-archetype.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_assigning-application-credentials.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-and-running-an-application-analysis.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-git-repos.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-jira-credentials.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-maven-credentials.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-maven-repo.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-proxy-credentials.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-proxy-settings.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-source-control-credentials.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_configuring-subversion-repos.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_controlling-task-order-with-task-manager.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-a-business-service.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-a-jira-connection.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-a-stakeholder.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-a-tag.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-application-tags.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-custom-migration-targets.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-jira-issues-for-migration-wave.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_creating-migration-waves.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_defining-an-archetype.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_displaying-automated-tasks.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_displaying-the-tags-of-an-application.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_downloading-an-analysis-report.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_importing-an-app-list.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_managing-mta-questionnaires.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_manual-tagging-of-an-application.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_reviewing-a-task-log.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_reviewing-an-analysis-report.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_reviewing-an-application.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_reviewing-an-archetype.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_reviewing-assessment-report.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/proc_setting-default-credentials.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/ref_custom-questionnaire-fields.adoc` (content)<br>  ⚔️ `docs/topics/mta-ui/ref_yaml-template-for-custom-questionnaire.adoc` (content)<br>  ⚔️ `docs/web-console-guide/master.adoc` (content)<br><br>These conflicts must be resolved before merging into `main`. | Resolve conflicts locally and push changes to this branch. |\n\n<details>\n<summary>✅ Passed checks (3 passed)</summary>\n\n|     Check name     | Status   | Explanation                                                                                                                                                                                                            |\n| :----------------: | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n|     Title check    | ✅ Passed | The title references the specific issue (MTA-6439) and directly describes the main problem being addressed: Dockerfiles not being generated by the generate helm command, which aligns with the documentation changes. |\n| Docstring Coverage | ✅ Passed | No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.                                                                                                             |\n|  Description Check | ✅ Passed | Check skipped - CodeRabbit’s high-level summary is enabled.                                                                                                                                                            |\n\n</details>\n\n<sub>✏️ Tip: You can configure your own custom pre-merge checks in the settings.</sub>\n\n</details>\n\n<!-- pre_merge_checks_walkthrough_end -->\n\n<!-- finishing_touch_checkbox_start -->\n\n<details>\n<summary>✨ Finishing Touches</summary>\n\n- [ ] <!-- {\"checkboxId\": \"7962f53c-55bc-4827-bfbf-6a18da830691\"} --> 📝 Generate docstrings\n<details>\n<summary>🧪 Generate unit tests (beta)</summary>\n\n- [ ] <!-- {\"checkboxId\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\", \"radioGroupId\": \"utg-output-choice-group-unknown_comment_id\"} -->   Create PR with unit tests\n- [ ] <!-- {\"checkboxId\": \"07f1e7d6-8a8e-4e23-9900-8731c2c87f58\", \"radioGroupId\": \"utg-output-choice-group-unknown_comment_id\"} -->   Post copyable unit tests in a comment\n- [ ] <!-- {\"checkboxId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\", \"radioGroupId\": \"utg-output-choice-group-unknown_comment_id\"} -->   Commit unit tests in branch `mta-6439-helm-structure-values-k8s-non-k8s`\n\n</details>\n<details>\n<summary>⚔️ Resolve merge conflicts (beta)</summary>\n\n- [ ] <!-- {\"checkboxId\": \"c3a5b2e1-4d7f-4a8c-b9d6-e1f2c3d4a5b6\", \"radioGroupId\": \"merge-conflict-output-choice-group-unknown_comment_id\"} -->   Auto-commit resolved conflicts to branch `mta-6439-helm-structure-values-k8s-non-k8s`\n- [ ] <!-- {\"checkboxId\": \"d4b6c3f2-5e8g-5b9d-c0e7-f2g3d4e5b6c7\", \"radioGroupId\": \"merge-conflict-output-choice-group-unknown_comment_id\"} -->   Create stacked PR with resolved conflicts\n- [ ] <!-- {\"checkboxId\": \"e5c7d4g3-6f9h-6c0e-d1f8-g3h4e5f6c7d8\", \"radioGroupId\": \"merge-conflict-output-choice-group-unknown_comment_id\"} -->   Post resolved changes as copyable diffs in a comment\n\n</details>\n\n</details>\n\n<!-- finishing_touch_checkbox_end -->\n\n<!-- tips_start -->\n\n---\n\n\n\n<sub>Comment `@coderabbitai help` to get the list of available commands and usage tips.</sub>\n\n<!-- tips_end -->\n\n<!-- internal state start -->\n\n\n<!-- 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 -->\n\n<!-- internal state end -->"},"request":{"retryCount":3,"retries":3,"retryAfter":16}}}

appName: my-app-production # Overrides application name in the discovery manifest
database:
host: prod-postgres.company.com # Overrides host value in the discovery manifest
redis: # Adds a new field in the values file
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Can you please double check if "in the values file" clear/correct? Because as a reader I think the values file is the file you're creating in those lines (83-87)

Copy link
Copy Markdown

@gciavarrini gciavarrini left a comment

Choose a reason for hiding this comment

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

Excellent work 👏🏻
You handled the complexity of this topic perfectly, and the document is very clear. Thanks for addressing all the previous comments so thoroughly.

I have one minor note left, but overall this is a definite LGTM.

@Pkylas007
Copy link
Copy Markdown
Collaborator Author

Hello @rromannissen,

Can you please review this PR? I think I've added the requirements in MTA-6439 Dockerfile Not Generated by generate helm. Please let me know if you're ok with it. Thanks much!

@Pkylas007
Copy link
Copy Markdown
Collaborator Author

Excellent work 👏🏻 You handled the complexity of this topic perfectly, and the document is very clear. Thanks for addressing all the previous comments so thoroughly.

I have one minor note left, but overall this is a definite LGTM.

Thank you for your detailed feedback 😃

Copy link
Copy Markdown
Collaborator

@mpershina mpershina left a comment

Choose a reason for hiding this comment

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

Overall, LGTM, but there are some issues with rendering (see the txt file attacjed to the corresponding comment) and general minor issues that need fixes.

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@Pkylas007 Pkylas007 force-pushed the mta-6439-helm-structure-values-k8s-non-k8s branch from 398135c to ac587bf Compare March 5, 2026 07:21
@rromannissen
Copy link
Copy Markdown

rromannissen commented Mar 18, 2026

I see the documentation keeps referring to "deployment manifest", when it should be plural instead: "deployment manifests".

Hi @rromannissen ,
I have updated all references to deployment manifests in the guide. Could you take a quick look, please?


:_mod-docs-content-type: REFERENCE

[id="discover-values-deployment_{context}"]
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I'm not sure I understand what this section is trying to explain. I assume it's about the possibility to override values, but I find it very confusing. I think it would make sense to include CLI commands with their respective flags to provide context for each scenario.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Ok, I have converted the reference topic into a procedure to include commands for the steps. Can you please let me know if this makes sense? Thanks!

Prabha Kylasamiyer Sundara Rajan added 3 commits March 19, 2026 12:02
… into a procedure

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@Pkylas007 Pkylas007 requested a review from rromannissen March 19, 2026 06:53
+
[source, terminal]
----
$ *mta-cli generate helm --chart-dir helm_sample* \
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

How are you referencing that values.yaml file in here? Where is that file located? How come it is overriding values from the discovery manifest if it is not being passed as a parameter in the command? The cat commands are not useful, what we need to understand here is the mechanics of overriding values. By the way, I don't think this works the way you are explaining here, because as far I can remember, the only way to override values from the discovery manifest was by using the --set flag to pass discrete values. I'll let @gciavarrini keep me honest here.

Copy link
Copy Markdown
Collaborator Author

@Pkylas007 Pkylas007 Mar 20, 2026

Choose a reason for hiding this comment

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

@rromannissen Hi Ramon,

Thank you for your evaluation.
Gloria will be back only by March end. So, I did my best to try a few commands to check if I can pass the values file as a parameter as you mentioned. However, please note this command is not verified by @gciavarrini. Would you mind going through the changes to ensure that the updates cover the points you shared here? Much appreciate your feedback, thanks!

Prabha Kylasamiyer Sundara Rajan added 2 commits March 20, 2026 15:07
…added a reference for discovery manifest

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@Pkylas007 Pkylas007 requested a review from rromannissen March 20, 2026 09:54
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants