mirror of
https://github.com/docker/docs.git
synced 2026-04-05 02:38:52 +07:00
850fde24e2
* Add validate page in the toc as it was missing * Update publishing process Introduce self-published and docker reviewd notions Apply suggestions from code review Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Co-authored-by: Felipe Cruz Martinez <15997951+felipecruz91@users.noreply.github.com> * Add cards for publishing option to make them more visible * Add images on cards * Add description on the cards * Mention self-published extension in the end users docs page as well * Use buttons rather than cards * Apply suggestions from code review * Update desktop/extensions-sdk/extensions/publish.md --------- Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Co-authored-by: Felipe Cruz Martinez <15997951+felipecruz91@users.noreply.github.com>
43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
---
|
||
description: Understand the process of creating an extension.
|
||
title: The build and publish process
|
||
keyword: Docker Extensions, sdk, build, create, publish
|
||
---
|
||
|
||
The documentation is structured so that it matches the steps you need to take when creating your extension. There are two main parts to creating a Docker Extension; build the foundations and then publish your extension.
|
||
|
||
### Part one: Build the foundations
|
||
|
||
The build process consists of:
|
||
|
||
- Installing the latest version of Docker Desktop.
|
||
- Setting up the directory with files which range from the extension’s source code to the required extension-specific files.
|
||
- Creating the Dockerfile to build, publish, and run your extension in Docker Desktop.
|
||
- Configuring the metadata file which is required at the root of the image filesystem.
|
||
- Building and installing the extension.
|
||
|
||
> Note
|
||
>
|
||
> Whilst you're building your extension, make sure you follow our [design](design/design-guidelines.md) and [UI styling](design/index.md) guidelines to ensure visual consistency and [level AA accessibility standards](https://www.w3.org/WAI/WCAG2AA-Conformance){:target="_blank" rel="noopener" class="_"}.
|
||
|
||
For further inspiration, see the other examples in the [samples folder](https://github.com/docker/extensions-sdk/tree/main/samples){:target="_blank" rel="noopener" class="_"}.
|
||
|
||
### Part two: Publish and distribute your extension
|
||
|
||
Docker Desktop displays published extensions in the Extensions Marketplace. The Extensions Marketplace is a curated space where developers can discover extensions to improve their developer experience and upload their own extension to share with the world.
|
||
|
||
If you want your extension to be published in the Marketplace, see our [publish](./extensions/publish.md)
|
||
documentation page.
|
||
|
||
{% include extensions-form.md %}
|
||
|
||
## What’s next?
|
||
|
||
If you want to get up and running quickly with a Docker Extension, see the [Quickstart guide](quickstart.md).
|
||
|
||
Alternatively, get started with Part one: Build for more in-depth information about each step of the extension creation process.
|
||
|
||
For an in-depth tutorial of the entire build process, we recommend the following video walkthrough from DockerCon 2022:
|
||
|
||
<iframe width="560" height="315" src="https://www.youtube.com/embed/Yv7OG-EGJsg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|