In the last post, we shared the news that this year Docker is celebrating Hacktoberfest 2022 with the open-source developer communities. In this blog post, you will see how to get started with Docker Extensions. We have compiled tutorials, videos and reference links that you can follow to get started with Docker Extensions in a simpler way. Let's jump in.
🏗️How to Build Your First Docker Extension
To get started, you can create your first Docker Extension in minutes. See details in our QuickStart guide.
In a nutshell:
- If you have not Docker Desktop installed yet, install Docker Desktop.
- in a terminal, type
docker extension init my-extension
It will prompt you for a Docker image name for your extension, and a few details. This will generate a hello-world extension with a basic UI and a connected backend service (optional).
- navigate to the generated folder, and type
make install-extension
to build and install the generated extension.
- Open Docker Desktop Dashboard and test the extension by navigating to the
Test-Extension
tab. You now have a running extension!
Please Note:
When adding an extension, you can also specify if you accept Hacktoberfest contributions in your extension, that will encourage other people to participate and improve the extension you propose.
If you have any questions, join our Community Slack channel #extensions.
🗣️Propose Your Docker Extension in the Hacktoberfest List
- Once you have a GitHub repo for your extension, edit the
README.md
and describe your extension, the pain point or user needs it solves. - Push the new Git repo to your GithHub account
git remote add origin https://github.com/my-account/my-extension.git
git push -u origin main
- Fork https://github.com/docker/hacktoberfest-2022 repo
- In your local clone of
docker/harcktoberfest
repo, add your extension in the list (inREADME.md
). Don't forget to include:- extension name, and a one line description
- Github repo for the description
- status of the Extension you add:
idea
(if you have not started to actually code the extension),Community
(some code has been started),functional
(functionality is implemented) - specify if you accept PRs from other Hacktoberfest participant (set
hacktoberfest
label on your git repo)
- commit your changes and push a branch on your local fork, and create a Pull Request in docker/harcktoberfest with your branch
📹Videos
💬Support and Community
If you do get enough interest to build a Docker Extension, the team at Docker is available to support you.
You can find us in the Docker Forum, post issues on our SDK repo, or reach us via email extensions(AT)docker.com.
References:
- Introduction to Docker Extensions
- How to create your own Docker Extensions
- Create Your First Extensions
- Minimal frontend extensions tutorial
- Minimal React Extensions tutorial
- Minimal Docker CLI Extensions tutorial
Getting Help
Have a question about Hacktoberfest and Docker Extensions? Search the Docker Forum Docker Extension tag for answers, or post a question in our Docker Community Forum.