feat(deployment): add "next" tag support with default values for version and method (#24)

- Helm: resolves "next" to semantic version by querying rhdh-hub-rhel9 image tags
- Operator: uses main branch and --next flag for non-semantic versions
- Default RHDH_VERSION to "next" and INSTALLATION_METHOD to "helm" when not set
- Bump version to 1.1.6

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: subhashkhileri

docs/.vitepress/config.ts

@@ -32,7 +32,7 @@ export default defineConfig({
       { text: "Tutorials", link: "/tutorials/" },
       { text: "Examples", link: "/examples/" },
       {
-        text: "v1.1.2",
+        text: "v1.1.6",
         items: [{ text: "Changelog", link: "/changelog" }],
       },
     ],

docs/changelog.md

@@ -2,7 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
-## [1.1.5] - Current
+## [1.1.6] - Current
+
+### Added
+- **"next" tag support**: Both Helm and Operator deployments now support `RHDH_VERSION=next`
+  - Helm: Resolves "next" to semantic version by querying `rhdh-hub-rhel9` image tags
+  - Operator: Uses `main` branch and `--next` flag instead of release branch
+
+### Changed
+- **Default values**: `RHDH_VERSION` defaults to `next` and `INSTALLATION_METHOD` defaults to `helm` when not set
+
+### Environment Variables
+- `RHDH_VERSION`: RHDH version to deploy (default: `next`)
+- `INSTALLATION_METHOD`: Deployment method - `helm` or `operator` (default: `helm`)
+
+## [1.1.5]
 
 ### Added
 - **Plugin metadata auto-generation**: When `dynamic-plugins.yaml` doesn't exist, configuration is automatically generated from `metadata/*.yaml` files

package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhdh-e2e-test-utils",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "Test utilities for RHDH E2E tests",
   "license": "Apache-2.0",
   "type": "module",

src/deployment/rhdh/deployment.ts

@@ -187,9 +187,30 @@ export class RHDHDeployment {
       `/tmp/${this.deploymentConfig.namespace}-subscription.yaml`,
       yaml.dump(subscriptionObject),
     );
+
+    const version = this.deploymentConfig.version;
+    const isSemanticVersion = /^\d+(\.\d+)?$/.test(version);
+
+    // Use main branch for non-semantic versions (e.g., "next", "latest")
+    const branch = isSemanticVersion ? `release-${version}` : "main";
+
+    // Build version argument based on version type
+    let versionArg: string;
+    if (isSemanticVersion) {
+      versionArg = `-v ${version}`;
+    } else if (version === "next") {
+      versionArg = "--next";
+    } else {
+      throw new Error(
+        `Invalid RHDH version "${version}". Use semantic version (e.g., "1.5") or "next".`,
+      );
+    }
+
+    this._log(`Using operator branch: ${branch}, version arg: ${versionArg}`);
+
     await $`
       set -e;
-      curl -s https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/release-${this.deploymentConfig.version}/.rhdh/scripts/install-rhdh-catalog-source.sh | bash -s -- -v ${this.deploymentConfig.version} --install-operator rhdh
+      curl -sf https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/${branch}/.rhdh/scripts/install-rhdh-catalog-source.sh | bash -s -- ${versionArg} --install-operator rhdh
 
       timeout 300 bash -c '
         while ! oc get crd/backstages.rhdh.redhat.com -n "${this.deploymentConfig.namespace}" >/dev/null 2>&1; do
@@ -257,8 +278,16 @@ export class RHDHDeployment {
   }
 
   private async _resolveChartVersion(version: string): Promise<string> {
-    // Semantic versions (e.g., 1.2)
-    if (/^(\d+(\.\d+)?)$/.test(version)) {
+    let resolvedVersion = version;
+
+    // Handle "next" tag by looking up the corresponding version from downstream image
+    if (version === "next") {
+      resolvedVersion = await this._resolveVersionFromNextTag();
+      this._log(`Resolved "next" tag to version: ${resolvedVersion}`);
+    }
+
+    // Semantic versions (e.g., 1.2, 1.10)
+    if (/^(\d+(\.\d+)?)$/.test(resolvedVersion)) {
       const response = await fetch(
         "https://quay.io/api/v1/repository/rhdh/chart/tag/?onlyActiveTags=true&limit=600",
       );
@@ -271,28 +300,73 @@ export class RHDHDeployment {
       const data = (await response.json()) as { tags: Array<{ name: string }> };
       const matching = data.tags
         .map((t) => t.name)
-        .filter((name) => name.startsWith(`${version}-`))
+        .filter((name) => name.startsWith(`${resolvedVersion}-`))
         .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
 
       const latest = matching.at(-1);
-      if (!latest) throw new Error(`No chart version found for ${version}`);
+      if (!latest)
+        throw new Error(`No chart version found for ${resolvedVersion}`);
       return latest;
     }
 
     // CI build versions (e.g., 1.2.3-CI)
-    if (version.endsWith("CI")) return version;
+    if (resolvedVersion.endsWith("CI")) return resolvedVersion;
 
     throw new Error(`Invalid Helm chart version format: "${version}"`);
   }
 
+  /**
+   * Resolve the semantic version from the "next" tag by looking up the
+   * downstream image (rhdh-hub-rhel9) and finding tags with the same digest.
+   */
+  private async _resolveVersionFromNextTag(): Promise<string> {
+    // Fetch all active tags in a single API call
+    const response = await fetch(
+      "https://quay.io/api/v1/repository/rhdh/rhdh-hub-rhel9/tag/?onlyActiveTags=true&limit=75",
+    );
+
+    if (!response.ok) {
+      throw new Error(`Failed to fetch image tags: ${response.statusText}`);
+    }
+
+    // Use Record to avoid snake_case linting issues with Quay API response
+    const data = (await response.json()) as {
+      tags: Array<Record<string, unknown>>;
+    };
+
+    // Find the "next" tag and get its digest
+    const nextTag = data.tags.find((t) => t["name"] === "next");
+    if (!nextTag) {
+      throw new Error('No "next" tag found in rhdh-hub-rhel9 repository');
+    }
+
+    const digest = nextTag["manifest_digest"] as string;
+    this._log(`"next" tag digest: ${digest}`);
+
+    // Find semantic version tag (e.g., "1.10") with the same digest
+    const semanticVersionTag = data.tags.find(
+      (t) =>
+        t["manifest_digest"] === digest &&
+        /^\d+\.\d+$/.test(t["name"] as string),
+    );
+
+    if (!semanticVersionTag) {
+      throw new Error(
+        `Could not find semantic version tag for "next" (digest: ${digest})`,
+      );
+    }
+
+    return semanticVersionTag["name"] as string;
+  }
+
   private _buildDeploymentConfig(input: DeploymentOptions): DeploymentConfig {
-    const version = input.version ?? process.env.RHDH_VERSION;
+    // Default to "next" if RHDH_VERSION not set
+    const version = input.version ?? process.env.RHDH_VERSION ?? "next";
+    // Default to "helm" if INSTALLATION_METHOD not set
     const method =
-      input.method ?? (process.env.INSTALLATION_METHOD as DeploymentMethod);
-
-    if (!version) throw new Error("RHDH version is required");
-    if (!method)
-      throw new Error("Installation method (helm/operator) is required");
+      input.method ??
+      (process.env.INSTALLATION_METHOD as DeploymentMethod) ??
+      "helm";
 
     const base: DeploymentConfigBase = {
       version,