Have you ever wanted to contribute to an open source project and community? This guide will help you understand the overall organization of the Kubecost project, and direct you to the best places to get started contributing. You’ll be able to share ideas, pick up issues, write code to fix them, and get your work reviewed and merged.
This document is the single source of truth for how to contribute to the code base. Feel free to browse the open issues and file new ones, all feedback is welcome!
This is your guide and roadmap to getting started as a Kubecost community member. The contributor guide outlines a list of prerequisites that need to be completed before you are able to start contributing, for example we ask all community members to review the Code of Conduct prior to jumping in.
Join our community
Kubecost is a growing, lively, friendly open-source community. As many open source projects often do, it depends on new people becoming members and regular contributors of new ideas and implementation. Please consider joining the discussion around Kubecost, and making your first contribution to our community today. We ask our members to join the following channels of communication so we can better support you through your onboarding journey.
- Slack community - check out #support for any help you may need & drop your introduction in the #general channel
- Kubecost Documentation
- Social media & blog
If you have any questions please reach out: firstname.lastname@example.org
Welcome to Kubecost! This guide is broken up into the following sections. It is recommended that you follow these steps in order:
- Prerequisites: these tasks are required and need to be completed before you can start contributing to Kubecost
- Your First Contribution: things you need to know before making your first contribution
- Contributing: the main reference guide to contributing to Kubecost
Before submitting code to Kubecost, you should first complete the following prerequisites.
Code of conduct
Please make sure to read and observe the code of conduct and Community Values.
Setting up your development environment
Contributing to our project
Thanks for your help improving the project!
If you have a question about Kubecost or have encountered problems using it, you can start by asking a question on Slack or via email at email@example.com. You can also visit https://docs.kubecost.com/
This repository's contribution workflow follows a typical open-source model:
- Fork this repository
- Work on the forked repository
- Open a pull request to merge the fork back into this repository
Follow these steps to build from source and deploy:
docker build --rm -f "Dockerfile" -t /kubecost-cost-model: .
Edit the pulled image in the deployment.yaml to /kubecost-cost-model:
Set this environment variable to the address of your prometheus server
kubectl create namespace cost-model
kubectl apply -f kubernetes/ --namespace cost-model
kubectl port-forward --namespace cost-model service/cost-model 9003
To test, build the cost-model docker container and then push it to a Kubernetes cluster with a running Prometheus.
To confirm that the server is running, you can hit http://localhost:9003/costDataModel?timeWindow=1d
In order to run cost-model locally, or outside of the runtime of a Kubernetes cluster, you can set the environment variable KUBECONFIG_PATH.
Running the integration tests
To run these tests:
Make sure you have a kubeconfig that can point to your cluster, and have permissions to create/modify a namespace called "test"
Connect to your the prometheus kubecost emits to on localhost:9003: kubectl port-forward --namespace kubecost service/kubecost-prometheus-server 9003:80
Temporary workaround: Copy the default.json file in this project at cloud/default.json to /models/default.json on the machine your test is running on. TODO: fix this and inject the cloud/default.json path into provider.go.
Navigate to cost-model/test
Run go test -timeout 700s from the testing directory. The tests right now take about 10 minutes (600s) to run because they bring up and down pods and wait for Prometheus to scrape data about them.
Certification of origin
By contributing to this project you certify that your contribution was created in whole or in part by you and that you have the right to submit it under the open source license indicated in the project. In other words, please confirm that you, as a contributor, have the legal right to make the contribution.
Please write a commit message with Fixes Issue # if there is an outstanding issue that is fixed. It’s okay to submit a PR without a corresponding issue, just please try to be detailed in the description about the problem you’re addressing.
Please run go fmt on the project directory. Lint can be okay (for example, comments on exported functions are nice but not required on the server).
Thanks for your help improving the project!
Where can I go for help?
If you need help, you can ask questions on our mailing list, Slack community , or GitHub issues [list any other communication platforms that your project uses].
What does the code of conduct mean for me?
Our code of conduct means that you are responsible for treating everyone on the project with respect and courtesy regardless of their identity. If you are the victim of any inappropriate behavior or comments as described in our code of conduct, we are here for you and will do the best to ensure that the abuser is reprimanded appropriately, per our code. Please report any incidents here: firstname.lastname@example.org