netdata/devenv Docker Image Overview

netdata/devenv

A container with all the tools a software developer needs to work on the Netdata Agent.

0 次下载

Devenv

A Developer Environment (or devenv for short) is a workspace for developers to make changes without breaking anything in a live environment.

In order to foster contribution for the Netdata Agent and it's various collectors, we created an image that is a devenv on it's own, a fully containerized environment where it has everything a developer needs to develop improvements on the Netdata Agent itself or it's collectors.

We have included all the dependencies that you need to build the Netdata Agent and it's collectors. We have additionally included many of the tools we use for checking PRs, including various linters like flake8 and shellcheck You only need to download your forked repositories and you can begin developing right away!

Dockerfile

Inside this repository you can find the Dockerfile which is used to create the development environment Docker image. It is automatically published on DockerHub, using a CI/CD pipeline based on GitHub Actions.

How to use the Devenv

This devenv makes use of:

Required:
- Docker
Optional:
- VS Code, one of the most used open source editors on the Internet.
- Remote Containers VS Code extension.

Quickstart

Download VS Code.
Download Docker.
Fork the GitHub repository you want to contribute to: netdata/netdata
Clone the forked repository to your development machine: git clone [***] netdata.
Clone the community repository: git clone [***] community.
copy and paste the .devcontainer folder inside the netdata directory. You will find the .devcontainer folder inside the community repository you just downloaded: community/devenv/.devcontainer.
Open the netdata directory using VS Code and click on the popup as it is shown in the GIF bellow. It will re-open the directory from inside the Netdata Devenv.

!VS code

This directory is synced in real time between your development machine and the developer container. Any file that you place inside the netdata directory, will be copied inside the netdata directory of the container.

You are now ready to develop inside the Container!

Finally, we have installed some VS Code extensions that you might need, but you are free to install more extensions inside the container. -

Note that any locally installed VS Code extension you might already have, will not work unless you install it inside the container.

The hard way

You are free to docker pull netdata/devenv the container, attach a terminal session to it and start developing right away! The container has everything you need to get going.