{
 "schema": "aiblocks-page/1",
 "id": "prepare-a-quarkus-native-build",
 "type": "skill",
 "name": "Quarkus native build troubleshooter",
 "summary": "Share your Quarkus version, target and build log. Get compatible fixes and artifact checks.",
 "headline": "Quarkus native build troubleshooter",
 "subhead": "Share the Quarkus project, target platform and build logs. Match the tools to the target. Get fixes and checks for the built app.",
 "job": {
  "id": "ship-and-host",
  "name": "Ship and host your app"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "codebase",
   "required": true,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  },
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  }
 ],
 "outputs": [
  {
   "type": "code_change",
   "required": true,
   "label": "Code change",
   "what": "a change to the code, with what it fixes and how it was checked"
  },
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  },
  {
   "type": "test_report",
   "required": true,
   "label": "Test report",
   "what": "what was tested, what passed, what failed and why"
  }
 ],
 "you_give": [
  "Your Quarkus project files, such as pom.xml or build.gradle",
  "Your Quarkus version and build tool (Maven or Gradle)",
  "Your target: your own machine, a Linux container, Kubernetes or OpenShift",
  "Your build log or runtime error (optional)"
 ],
 "you_get": [
  "The right build command for your Quarkus version and target.",
  "A list of faults, each with cause, fix and the file or setting to change.",
  "Steps to test the native binary, not just the Java build.",
  "Container image and Kubernetes or OpenShift settings to review before you deploy."
 ],
 "use_when": [
  "Your Quarkus native build fails and you do not know why.",
  "Your native app builds but throws ClassNotFoundException when it runs.",
  "You need a container image or Kubernetes manifests for a Quarkus app.",
  "You are building native on a Mac or Windows PC and the binary will not start."
 ],
 "skip_when": [
  "Your project is not Quarkus. Use the java-add-graalvm-native-image-support skill if you have it, or read the GraalVM native image docs.",
  "You only need a normal Java build. Run the standard Maven or Gradle package step, no native flags needed.",
  "You want to move to a newer Quarkus version. Use the quarkus update command from the Quarkus upgrade guide."
 ],
 "output_sample": {
  "input": [
   "Your Quarkus project files, such as pom.xml or build.gradle",
   "Your Quarkus version and build tool (Maven or Gradle)",
   "Your target: your own machine, a Linux container, Kubernetes or OpenShift",
   "Your build log or runtime error (optional)"
  ],
  "prerequisites": [
   "Docker or Podman for a container build, or Mandrel or GraalVM installed for a local build",
   "An AI that can read your project files, or paste the key files into the chat"
  ],
  "output": [
   {
    "name": "Build command",
    "contains": "The exact Maven or Gradle command and flags that fit your Quarkus version and target."
   },
   {
    "name": "Native failures",
    "contains": "Each build or runtime fault with its cause, the fix and the file or property to change."
   },
   {
    "name": "Test the native binary",
    "contains": "How to run the integration test against the native binary, and how to run it on a non-Linux host."
   },
   {
    "name": "Container image",
    "contains": "Steps to add a Jib or Docker image extension and set the image name, registry and tag."
   },
   {
    "name": "Kubernetes or OpenShift manifests",
    "contains": "The extension to add, the properties to set and which generated file to review."
   },
   {
    "name": "Check list",
    "contains": "Checks to run on the real artifact before you deploy."
   }
  ]
 },
 "how_to_use": [
  "Open your AI tool and paste the skill text, or add the skill folder if your tool takes files.",
  "Paste your pom.xml or build.gradle and say which Quarkus version you use.",
  "Say where the app will run, such as a Linux container or Kubernetes.",
  "Paste your build log or runtime error if you have one.",
  "Read the fixes, then run the build yourself. A native build needs Docker, Podman or Mandrel on your machine and can take minutes.",
  "Check the generated YAML and keep secrets out of it before you deploy.",
  "Next, run the native build in CI or on demand, not on every test run. Native builds are slow and use several GB of memory. Check the Kubernetes YAML again before any deploy."
 ],
 "checks": [],
 "next": [
  {
   "name": "Service rollout and rollback planner",
   "url": "https://useaiblocks.com/skills/copilot-devops-rollout-plan",
   "why": "Service rollout and rollback planner"
  }
 ],
 "source": {
  "by": "github",
  "repo": "github/awesome-copilot",
  "url": "https://github.com/github/awesome-copilot/tree/613efc8c21d9b3ce642dff361d17006cd9967e28/skills/quarkus-native-and-container",
  "licence": "MIT",
  "original_name": "quarkus-native-and-container",
  "commit": "613efc8c21d9b3ce642dff361d17006cd9967e28"
 },
 "credits": [
  {
   "title": "quarkus-native-and-container skill",
   "by": "github",
   "url": "https://github.com/github/awesome-copilot/tree/613efc8c21d9b3ce642dff361d17006cd9967e28/skills/quarkus-native-and-container",
   "used": "Original instructions and supporting files, with attribution and the MIT licence. Display copy describes the task."
  }
 ],
 "files": [
  "LICENSE"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/prepare-a-quarkus-native-build",
  "markdown": "https://useaiblocks.com/skills/prepare-a-quarkus-native-build.md",
  "json": "https://useaiblocks.com/skills/prepare-a-quarkus-native-build.json",
  "instructions": "https://useaiblocks.com/skills/prepare-a-quarkus-native-build/SKILL.md",
  "download": "https://useaiblocks.com/skills/prepare-a-quarkus-native-build.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/prepare-a-quarkus-native-build",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/prepare-a-quarkus-native-build",
  "mcp": "https://useaiblocks.com/mcp"
 }
}