Skip to content

docs(immich): sync template standards updates#354

Open
mberlofa wants to merge 2 commits into
mainfrom
docs/immich-template-standards-sync
Open

docs(immich): sync template standards updates#354
mberlofa wants to merge 2 commits into
mainfrom
docs/immich-template-standards-sync

Conversation

@mberlofa

@mberlofa mberlofa commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Summary

  • sync Immich docs for template-standards chart update
  • document networkPolicy.extraEgress
  • add Immich to the playground site-sync registry and expose network policy controls

Validation

  • npm run lint
  • npm run format:check
  • npm run build
  • make site-sync-check CHART=immich
  • make release-check REPO=site
  • make attribution-check REPO=site

Chart PR: helmforgedev/charts#676

Summary by CodeRabbit

  • New Features
    • Added the Immich chart to the site sync playground.
    • Introduced “Network Policy” options for the Immich chart, including configurable extra egress CIDR and port.
  • Documentation
    • Reformatted the Immich chart “Values” table to improve readability while keeping the listed parameters unchanged.

@coderabbitai

coderabbitai Bot commented Jul 3, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 87370954-f3a9-4ea1-8e08-b8bca5dac925

📥 Commits

Reviewing files that changed from the base of the PR and between fedd1a4 and 6281a30.

📒 Files selected for processing (1)
  • src/data/playground-configs.ts

📝 Walkthrough

Walkthrough

This PR adds immich network policy playground fields, enables immich in the playground chart list, and reformats the immich chart values table.

Changes

Immich playground and docs

Layer / File(s) Summary
Immich Network Policy fields
src/data/playground-configs.ts
Adds a gated Network Policy section with extra egress CIDR and port inputs for the immich chart.
Playground enablement and docs table
src/pages/playground.astro, src/pages/docs/charts/immich.mdx
Adds immich to siteSyncPlaygroundConfigs and reformats the immich Values table alignment without changing the listed parameters.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title is concise and accurately reflects the Immich docs and playground sync updates.
Description check ✅ Passed The description covers the summary and validation, but it omits the required Related Issue field and a template-style Quality Gates section.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/immich-template-standards-sync

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Caution

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

⚠️ Outside diff range comments (2)
src/data/playground-configs.ts (1)

236-262: 📐 Maintainability & Code Quality | 🟠 Major | ⚡ Quick win

Duplicate "Network Policy" section for apache.

Two separate field groups named Network Policy, both gated by networkPolicy.enabled, now exist in the same chart config array (lines 236-262 and 285-305). This renders two identically-titled collapsible sections in the playground UI instead of one, which is confusing and likely unintended — the new egress CIDR/port fields should be merged into the existing group.

♻️ Proposed fix: merge into the existing Network Policy group
     {
       name: 'Network Policy',
       collapsible: true,
       gateField: 'networkPolicy.enabled',
       fields: [
         {
           label: 'Restrict Ingress',
           key: 'networkPolicy.ingress.enabled',
           type: 'toggle',
           default: 'false',
           description: 'Restrict inbound traffic only when selectors are configured',
         },
         {
           label: 'Allow DNS',
           key: 'networkPolicy.egress.allowDns',
           type: 'toggle',
           default: 'true',
           description: 'Allow DNS egress',
         },
         {
           label: 'Allow Internet',
           key: 'networkPolicy.egress.allowInternet',
           type: 'toggle',
           default: 'true',
           description: 'Allow general outbound traffic',
         },
+        {
+          label: 'Extra Egress CIDR',
+          key: 'networkPolicy.extraEgress[0].to[0].ipBlock.cidr',
+          type: 'text',
+          default: '10.0.0.0/8',
+          description: 'Additional destination allowed by NetworkPolicy',
+        },
+        {
+          label: 'Extra Egress Port',
+          key: 'networkPolicy.extraEgress[0].ports[0].port',
+          type: 'number',
+          default: '443',
+          description: 'Additional TCP egress port',
+        },
       ],
     },
     ...
-    {
-      name: 'Network Policy',
-      collapsible: true,
-      gateField: 'networkPolicy.enabled',
-      fields: [
-        {
-          label: 'Extra Egress CIDR',
-          key: 'networkPolicy.extraEgress[0].to[0].ipBlock.cidr',
-          type: 'text',
-          default: '10.0.0.0/8',
-          description: 'Additional destination allowed by NetworkPolicy',
-        },
-        {
-          label: 'Extra Egress Port',
-          key: 'networkPolicy.extraEgress[0].ports[0].port',
-          type: 'number',
-          default: '443',
-          description: 'Additional TCP egress port',
-        },
-      ],
-    },

Also applies to: 285-305

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/data/playground-configs.ts` around lines 236 - 262, The playground config
defines two separate collapsible groups named Network Policy in the same chart
array, both using networkPolicy.enabled, which creates duplicate UI sections.
Merge the new egress CIDR/port fields into the existing Network Policy group in
playground-configs.ts rather than keeping a second group, and keep the unique
field keys under the same fields array so the apache config shows only one
section.
src/pages/playground.astro (1)

23-32: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Add Immich’s Network Policy controls to the curated playground config src/pages/playground.astro:23-32
Adding immich here only makes the chart selectable in the playground; the curated Immich config still overrides schema-generated fields and has no Network Policy group, so networkPolicy.extraEgress won’t surface.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/pages/playground.astro` around lines 23 - 32, Update the curated Immich
playground config so it includes the Network Policy controls instead of only
adding immich to siteSyncPlaygroundConfigs. In the playground config source used
by immich, preserve the schema-generated Network Policy group and ensure
networkPolicy.extraEgress is exposed rather than being overridden by custom
curated fields. Use the immich entry and the playground config definitions to
locate the override and merge in the missing group.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In `@src/data/playground-configs.ts`:
- Around line 236-262: The playground config defines two separate collapsible
groups named Network Policy in the same chart array, both using
networkPolicy.enabled, which creates duplicate UI sections. Merge the new egress
CIDR/port fields into the existing Network Policy group in playground-configs.ts
rather than keeping a second group, and keep the unique field keys under the
same fields array so the apache config shows only one section.

In `@src/pages/playground.astro`:
- Around line 23-32: Update the curated Immich playground config so it includes
the Network Policy controls instead of only adding immich to
siteSyncPlaygroundConfigs. In the playground config source used by immich,
preserve the schema-generated Network Policy group and ensure
networkPolicy.extraEgress is exposed rather than being overridden by custom
curated fields. Use the immich entry and the playground config definitions to
locate the override and merge in the missing group.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: bd0c49e2-ab2a-468e-9710-272a7f746575

📥 Commits

Reviewing files that changed from the base of the PR and between 365449a and fedd1a4.

📒 Files selected for processing (3)
  • src/data/playground-configs.ts
  • src/pages/docs/charts/immich.mdx
  • src/pages/playground.astro

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.

1 participant