feat: added quick start da #2

imprateeksh · 2025-11-09T20:12:05Z

Description

This PR introduces the quick start variation of Landing zone for cloud-native AI applications

Release required?

No release
Patch release (x.x.X)
Minor release (x.X.x)
Major release (X.x.x)

Release notes content

Quick start variation of Landing zone for cloud-native AI applications
Quick provisioning of watsonx.ai resources, watsonx Assistant, watson Discovery, Databases for Elasticsearch, Container Registry and Code Engine for rapid deployment of RAG based AI application along with Object Storage and Key Protect services.

Run the pipeline

If the CI pipeline doesn't run when you create the PR, the PR requires a user with GitHub collaborators access to run the pipeline.

Run the CI pipeline when the PR is ready for review and you expect tests to pass. Add a comment to the PR with the following text:

/run pipeline

Checklist for reviewers

If relevant, a test for the change is included or updated with this PR.
If relevant, documentation for the change is included or updated with this PR.

For mergers

Use a conventional commit message to set the release level. Follow the guidelines.
Include information that users need to know about the PR in the commit message. The commit message becomes part of the GitHub release notes.
Use the Squash and merge option.

imprateeksh · 2025-11-10T09:52:38Z

Code Engine failure is seen while testing locally. Once fixed, i will be able to test after creating catalog.
This failure is seen during image build creation from script here

ocofaigh

The diagram doesn't look right in dark mode. It also seems to have a load of empty space at the bottom?

ocofaigh

see initial comment

solutions/quickstart/main.tf

ocofaigh · 2025-11-13T09:45:35Z

solutions/quickstart/version.tf

+
+    restapi = {
+      source  = "Mastercard/restapi"
+      version = "1.20.0"


why are we still on version 1.x.x of restapi provider? Has our modules not been update to support v2.x.x ? Which module requires this so we can check?

You are right, this should be updated and the fix should be provided in watsonx.ai first. Will work on it. Here I referenced what is used in watsonx.ai module and if version was updated some failures were seen.

I remember there was a PR failing with this change.

This can be taken separately but let me see, I remember some issue was already present for this.

There was no issue created it seems but we have a renovate PR that's attempting the uprade. I have created a new issue to address this. Once updated , I will make changes here as well.

ibm_catalog.json

README.md

renovate.json

README.md

imprateeksh · 2025-11-14T13:09:06Z

The implemented code engine changes are failing as the region is picked is us-south always and main root module does not passes the region to build submodule. The fix is coming in the PR.

I will avoid this approach and call submodules instead which was done earlier untill the PR changes are merged.

Failure seen -
Passed the region as jp-tok in the .tfvars file and have resources created in the same region. But the build is picking as us-south.

imprateeksh · 2025-11-17T07:28:41Z

Updated diagram, empty stuff was because of one hidden item in the bottom of the diagram. Now removed and no issues in dark mode also.

imprateeksh · 2025-11-17T09:23:33Z

I am facing issues with Code Engine alone. This is bit strange, why the build is failing sometimes. I have reverted to the module usage - builds and apps.

imprateeksh · 2025-11-26T03:24:07Z

No more issues with code engine, able to deploy the app successfully.

…form-ibm-cloud-native-ai into solution-rag

imprateeksh · 2025-11-26T10:57:59Z

Tile as 1st index	Deployed

Output	Sample App

vburckhardt

I'd suggest reviewing the landing zone for containerized application in production and use the same approach overall. Some comments below.

vburckhardt · 2025-11-28T16:03:57Z

solutions/quickstart/main.tf

+# Watson Discovery
+##############################################################################################################
+
+module "watson_discovery" {


Looking at the logic, that variation is deploying every single watsonx service, including some advanced ones. I do not think it is really compatible with being a quick start. I'd suggest commenting out in the code the services that are not needed (so that someone can quickly uncomment if they want to customize and create their own DA). I think quick start should only have the bare minimum:

code engine

key protect

watsonx studio and runtime

sample app

the rest would be commented out by default in the code

vburckhardt · 2025-11-28T16:05:39Z

ibm_catalog.json

+        "app config"
+      ],
+      "short_description": "Automate a cloud-native AI deployment with supporting IBM Cloud and watsonx services, embed your enterprise data in generative AI solutions.",
+      "long_description": "Utilize data from your enterprise to achieve productivity gains in activities related to question/answer conversations, content search, summarization and generation. Cloud-native AI can be deployed in multiple configurations and is applicable to various industry use cases and solutions.\n\nThis deployable architecture provides a comprehensive foundation for trust, observability, security, and regulatory compliance by configuring and deploying various services and a sample application for a [RAG pattern](https://cloud.ibm.com/docs/pattern-genai-rag?topic=pattern-genai-rag-genai-pattern), including:\n- Configuring IBM Cloud Account with best practices from [IBM Cloud Framework for Financial Services](https://cloud.ibm.com/docs/framework-financial-services?topic=framework-financial-services-about)\n- Deploying key and secrets management services for storage and management of encryption keys and secrets\n- Deploying controls for continuous compliance\n- Deploying observability services for application and platform logging and monitoring\n- Deploying a suite of watsonx services to provide generative AI RAG capabilities\n- Deploying content databases for storing vector embeddings of the documents and content search/retrieval\n- Deploying a sample application in a variety of run times including CI/CD/CC pipelines for secure application lifecycle management\n\nThe above configured and deployed services enable a secure and trustworthy deployment of generative AI applications on IBM Cloud.\n\nThe configurations are flexible and be changed to meet the needs for several types of RAG patterns depending on the chosen combination of technologies and services.\n\nThe generative AI RAG pattern services include:\n- [watsonx.ai](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/welcome-main.html?context=wx)\n- [watsonx.data](https://cloud.ibm.com/docs/watsonxdata) (with Milvus)\n- [watsonx.governance](https://dataplatform.cloud.ibm.com/docs/content/svc-welcome/aiopenscale.html?context=wx)\n- [watsonx Assistant](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-welcome-new-assistant)\n- [watsonx Orchestrate](https://www.ibm.com/docs/en/watsonx/watson-orchestrate/current)\n- [Watson Discovery](https://cloud.ibm.com/docs/discovery-data)\n- [Elasticsearch](https://cloud.ibm.com/docs/databases-for-elasticsearch) Enterprise and Platinum edition\n\nThe supporting services include:\n- [Secrets Manager](https://cloud.ibm.com/docs/secrets-manager)\n- [Key Protect](https://cloud.ibm.com/docs/key-protect)\n- [Security and Compliance Center](https://cloud.ibm.com/docs/security-compliance)\n- [Event Notifications](https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-getting-started)\n- [Logs](https://cloud.ibm.com/docs/cloud-logs)\n- [Monitoring](https://cloud.ibm.com/docs/monitoring?topic=monitoring-getting-started)\n- [Object Storage](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-getting-started-cloud-object-storage)\n- [Continuous Delivery](https://cloud.ibm.com/docs/ContinuousDelivery) toolchains\n- [Container Registry](https://cloud.ibm.com/docs/Registry)\n\nA [sample RAG application](https://github.com/IBM/gen-ai-rag-watsonx-sample-application) is deployed to [Code Engine](https://cloud.ibm.com/docs/codeengine) or [Red Hat OpenShift](https://cloud.ibm.com/docs/openshift) cluster.\n\nBy leveraging this architecture, you can accelerate your deployment and tailor it to meet your unique business needs and enterprise goals.",


I think the description should describe a bit the difference between the variations as we're doing in landing zone for containerized application DA.

This solution enables the provisioning of cloud-native application landing zones on IBM Cloud using a range of configurations tailored to different needs — from quick experimentation to enterprise-grade deployments. Each variation offers a distinct balance of automation, integration with IBM Cloud services for security, observability, and compliance, and readiness for evaluation or production use. Whether you're deploying serverless applications on IBM Code Engine or containerized workloads on Red Hat OpenShift, these configurations help accelerate your cloud-native journey.

The landing zone includes three core configurations: Quick Start for lightweight experimentation, Basic for flexible serverless deployments on Code Engine with foundational services, and Standard for production-ready OpenShift clusters with advanced security and compliance. Both Basic and Standard also offer variants that include a deployed sample application with watsonx integration and CI/CD pipelines for secure lifecycle management.

vburckhardt · 2025-11-28T16:09:02Z

ibm_catalog.json

+        "app config"
+      ],
+      "short_description": "Automate a cloud-native AI deployment with supporting IBM Cloud and watsonx services, embed your enterprise data in generative AI solutions.",
+      "long_description": "Utilize data from your enterprise to achieve productivity gains in activities related to question/answer conversations, content search, summarization and generation. Cloud-native AI can be deployed in multiple configurations and is applicable to various industry use cases and solutions.\n\nThis deployable architecture provides a comprehensive foundation for trust, observability, security, and regulatory compliance by configuring and deploying various services and a sample application for a [RAG pattern](https://cloud.ibm.com/docs/pattern-genai-rag?topic=pattern-genai-rag-genai-pattern), including:\n- Configuring IBM Cloud Account with best practices from [IBM Cloud Framework for Financial Services](https://cloud.ibm.com/docs/framework-financial-services?topic=framework-financial-services-about)\n- Deploying key and secrets management services for storage and management of encryption keys and secrets\n- Deploying controls for continuous compliance\n- Deploying observability services for application and platform logging and monitoring\n- Deploying a suite of watsonx services to provide generative AI RAG capabilities\n- Deploying content databases for storing vector embeddings of the documents and content search/retrieval\n- Deploying a sample application in a variety of run times including CI/CD/CC pipelines for secure application lifecycle management\n\nThe above configured and deployed services enable a secure and trustworthy deployment of generative AI applications on IBM Cloud.\n\nThe configurations are flexible and be changed to meet the needs for several types of RAG patterns depending on the chosen combination of technologies and services.\n\nThe generative AI RAG pattern services include:\n- [watsonx.ai](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/welcome-main.html?context=wx)\n- [watsonx.data](https://cloud.ibm.com/docs/watsonxdata) (with Milvus)\n- [watsonx.governance](https://dataplatform.cloud.ibm.com/docs/content/svc-welcome/aiopenscale.html?context=wx)\n- [watsonx Assistant](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-welcome-new-assistant)\n- [watsonx Orchestrate](https://www.ibm.com/docs/en/watsonx/watson-orchestrate/current)\n- [Watson Discovery](https://cloud.ibm.com/docs/discovery-data)\n- [Elasticsearch](https://cloud.ibm.com/docs/databases-for-elasticsearch) Enterprise and Platinum edition\n\nThe supporting services include:\n- [Secrets Manager](https://cloud.ibm.com/docs/secrets-manager)\n- [Key Protect](https://cloud.ibm.com/docs/key-protect)\n- [Security and Compliance Center](https://cloud.ibm.com/docs/security-compliance)\n- [Event Notifications](https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-getting-started)\n- [Logs](https://cloud.ibm.com/docs/cloud-logs)\n- [Monitoring](https://cloud.ibm.com/docs/monitoring?topic=monitoring-getting-started)\n- [Object Storage](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-getting-started-cloud-object-storage)\n- [Continuous Delivery](https://cloud.ibm.com/docs/ContinuousDelivery) toolchains\n- [Container Registry](https://cloud.ibm.com/docs/Registry)\n\nA [sample RAG application](https://github.com/IBM/gen-ai-rag-watsonx-sample-application) is deployed to [Code Engine](https://cloud.ibm.com/docs/codeengine) or [Red Hat OpenShift](https://cloud.ibm.com/docs/openshift) cluster.\n\nBy leveraging this architecture, you can accelerate your deployment and tailor it to meet your unique business needs and enterprise goals.",


in addition, much of what is described in term of capabilities should be moved to feature of the corresponding variation (standard, basic) as those won't apply to all

vburckhardt · 2025-11-28T16:19:55Z

ibm_catalog.json

+          "label": "QuickStart",
+          "name": "quickstart",
+          "index": 1,
+          "short_description": "Ideal for users new to IBM Cloud or watsonx who want to get started without configuring underlying infrastructure.",


Best for rapid experimentation with minimal setup and lightweight resources.

feat: added quick start cnai

88a7c21

imprateeksh requested review from daniel-butler-irl and ocofaigh as code owners November 9, 2025 20:12

imprateeksh self-assigned this Nov 9, 2025

imprateeksh added 2 commits November 10, 2025 01:49

updated renovate and cra-config files.

2a3c14e

updated readme

78cdf2b

imprateeksh added 3 commits November 12, 2025 16:24

fix: added watsonx.data and governance

7030f8c

fix: added watsonx orchestrate

c1a1b87

fix: updated diagram and added new key to keyring

066440f

ocofaigh reviewed Nov 13, 2025

View reviewed changes

ocofaigh requested changes Nov 13, 2025

View reviewed changes

imprateeksh mentioned this pull request Nov 13, 2025

[cloud-native-ai] Add automation to track and update ICD version #3

Open

imprateeksh added 2 commits November 14, 2025 10:16

fix: addressed review comments

9e66213

code engine changes

7a80290

fix diagram issues

e1d4808

imprateeksh and others added 2 commits November 18, 2025 11:46

Merge branch 'main' into solution-rag

d458b1a

merged latest

ecffe14

imprateeksh added 6 commits November 26, 2025 08:55

fixed code engine build issue

8e12693

Merge branch 'solution-rag' of github.com:terraform-ibm-modules/terra…

2f1d31f

…form-ibm-cloud-native-ai into solution-rag

bumped submodule and addressed go security issue

4fbae0f

updated diagram

d4cad9f

added catalog onboarding file

b9444c5

updated catalog.json metadata to be in sync with rag-stack configuration

127be0e

imprateeksh mentioned this pull request Nov 26, 2025

fix: renovate failures and diagram changes terraform-ibm-modules/stack-ibm-retrieval-augmented-generation#276

Merged

6 tasks

updated index for quickstart as first index

58ad948

added description pointwise for qs variation

d51568c

imprateeksh requested a review from ocofaigh November 26, 2025 12:23

vburckhardt self-requested a review November 28, 2025 16:03

vburckhardt requested changes Nov 28, 2025

View reviewed changes

feat: added quick start da #2

Are you sure you want to change the base?

feat: added quick start da #2

Conversation

imprateeksh commented Nov 9, 2025

Description

Release required?

Release notes content

Run the pipeline

Checklist for reviewers

For mergers

Uh oh!

imprateeksh commented Nov 10, 2025

Uh oh!

ocofaigh left a comment

Choose a reason for hiding this comment

Uh oh!

ocofaigh left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

imprateeksh Nov 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

imprateeksh commented Nov 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

imprateeksh commented Nov 17, 2025

Uh oh!

imprateeksh commented Nov 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

imprateeksh commented Nov 26, 2025

Uh oh!

imprateeksh commented Nov 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vburckhardt left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

imprateeksh Nov 27, 2025 •

edited

Loading

imprateeksh commented Nov 14, 2025 •

edited

Loading

imprateeksh commented Nov 17, 2025 •

edited

Loading

imprateeksh commented Nov 26, 2025 •

edited

Loading

vburckhardt left a comment •

edited

Loading