/tags/formats/Recent content in Formats on Layer5 DocumentationHugoen/kanvas/reference/supported-formats/Mon, 01 Jan 0001 00:00:00 +0000/kanvas/reference/supported-formats/<p>This page lists exactly what Kanvas accepts and produces. For the steps, see <a href="/kanvas/guides/designs/import-designs/">Import and Merge Designs</a> and <a href="/kanvas/guides/designs/export-designs/">Export Designs</a>.</p> <h2 id="import" class="heading-link"> Import <a href="#import" class="heading-anchor" aria-label="Permalink to this heading">🔗</a> </h2> <p>Kanvas accepts the extensions <code>.yml</code>, <code>.yaml</code>, <code>.json</code>, <code>.tar</code>, <code>.tar.gz</code>, <code>.tgz</code>, <code>.gz</code>, and <code>.zip</code>. Detection is by content and takes the first match in the order below.</p> <table> <thead> <tr> <th>Order</th> <th>Format</th> <th>Extensions</th> <th>Detected when</th> <th>Notes</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>Meshery design</td> <td><code>.yml</code> <code>.yaml</code> <code>.json</code></td> <td>The schema version is a supported design version</td> <td>Lossless round trip of a design file export</td> </tr> <tr> <td>1</td> <td>Meshery design as OCI image</td> <td><code>.tar</code> <code>.tgz</code> <code>.tar.gz</code> <code>.zip</code></td> <td>The archive&rsquo;s layers contain a design file</td> <td>Only the first design is taken. Other layer files are ignored. No design file means failure.</td> </tr> <tr> <td>2</td> <td>Kubernetes manifest</td> <td><code>.yml</code> <code>.yaml</code></td> <td>One or more valid Kubernetes documents</td> <td>Multi-document files work. Unknown kinds are kept as generic objects.</td> </tr> <tr> <td>3</td> <td>Helm chart</td> <td><code>.tgz</code> <code>.tar.gz</code> <code>.gz</code> <code>.tar</code> <code>.zip</code></td> <td>A valid packaged chart</td> <td>An uncompressed <code>.tar</code> is reported as needing gzip. No values overrides.</td> </tr> <tr> <td>4</td> <td>Docker Compose</td> <td><code>.yml</code> <code>.yaml</code></td> <td>Converts as a Compose file</td> <td>The result is Kubernetes components.</td> </tr> <tr> <td>5</td> <td>Kustomize</td> <td><code>.yml</code> <code>.yaml</code> (kustomization), or an archive containing <code>kustomization.yaml</code></td> <td>The project builds</td> <td>Archive must contain every referenced file.</td> </tr> </tbody> </table> <p>If nothing matches, the import fails and lists why each format was rejected. The interface shows only the generic failure message.</p>