add-prod-local-profiles

Split Spring Boot 4 configuration into local and prod YAML profiles for Actuator and SpringDoc.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dprice-dev/claude-java-skills --skill add-prod-local-profiles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-prod-local-profiles
Source: https://github.com/dprice-dev/claude-java-skills/tree/main/.claude/skills/add-prod-local-profiles
Command: npx skills add https://github.com/dprice-dev/claude-java-skills --skill add-prod-local-profiles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents risky configuration defaults from leaking into production by cleanly separating local development visibility from production lockdown behavior for Spring Boot 4 Actuator and SpringDoc.

Core Features & Use Cases

  • Creates a locked-down application-prod.yaml that restricts Actuator to health,info and moves it to a dedicated management port.
  • Generates/updates application-local.yaml to expose all Actuator endpoints and enable Swagger UI/OpenAPI JSON for full local debugging.
  • Hardens the base application.yaml by ensuring show-details is safely set to never at the global level.
  • Activates the two-plane approach where local profile improves developer experience while prod profile reduces operational and information exposure risk.
  • Use case: After scaffolding or adding SpringDoc/Actuator, you want swagger and full actuator details in local only, while production keeps internal details off the public plane and isolates the management port.

Quick Start

Ask the skill to apply the prod/local split for your project by adding application-local.yaml and application-prod.yaml and updating application.yaml accordingly.

Frequently Asked Questions about add-prod-local-profiles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I separate Spring Boot Actuator configuration for dev and prod environments?

To separate Spring Boot Actuator configuration for dev and prod, split your YAML files into application-local.yaml and application-prod.yaml, restricting prod to health and info on a dedicated management port while exposing all endpoints locally.

How do I restrict Actuator endpoints in production but keep them open locally?

You can restrict Actuator endpoints in production by creating an application-prod.yaml profile that limits exposure to health and info on port 8081, while application-local.yaml exposes all endpoints for local debugging.

Does Spring Boot 4 require a separate management port for Actuator lockdown?

Spring Boot 4 does not strictly require a separate management port, but isolating Actuator on a dedicated port like 8081 is a recommended enterprise lockdown strategy to prevent management endpoint exposure on the primary application port.

How do I enable Swagger UI locally without exposing SpringDoc OpenAPI in production?

To enable Swagger UI locally without exposing it in production, use application-local.yaml to activate SpringDoc OpenAPI JSON and Swagger UI, while keeping the application-prod.yaml profile restricted to prevent public API documentation exposure.

Can I secure Spring Boot Actuator without altering security filters?

You can secure Spring Boot Actuator without altering security filters by applying YAML-only configuration changes that restrict endpoint exposure to health and info and isolate the management port, avoiding any Java security filter modifications.

Why does my Spring Boot application expose full Actuator details in production?

Your Spring Boot application likely exposes full Actuator details in production because the base application.yaml lacks a locked-down prod profile; setting show-details to never globally and restricting prod endpoints prevents this information leakage.