Skip to content

Commit 804275e

Browse files
committed
add contributing
1 parent bd04ae3 commit 804275e

File tree

2 files changed

+54
-2
lines changed

2 files changed

+54
-2
lines changed

.env.template

+2-2
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ PORT=2000
33
KUBERO_WEBHOOK_SECRET=mysecret
44

55
# Github webhook configuration
6-
KUBERO_WEBHOOK_URL=https://
6+
KUBERO_WEBHOOK_URL=https://kuberoXXXXXXXXXXXXX.loca.lt/api/repo/webhooks
77
GITHUB_PERSONAL_ACCESS_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
88

99
#GITEA_PERSONAL_ACCESS_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
@@ -12,7 +12,7 @@ GITHUB_PERSONAL_ACCESS_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
1212
KUBECONFIG_PATH=./kubeconfig
1313
KUBERO_CONFIG_PATH=./config.yaml
1414
KUBERO_CONTEXT=kind-kubero
15-
KUBERO_NAMESPACE=kubero
15+
KUBERO_NAMESPACE=kubero-dev
1616
KUBERO_SESSION_KEY=randomString
1717

1818
#GITHUB_CLIENT_SECRET=

CONTRIBUTING.md

+52
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# How to contribute
2+
3+
All contributions are welcome. For simple typos, just open a PR.
4+
For bigger ideas it might be better to open a issue first before you put a lot of work into it. This way we can discuss the idea first.
5+
6+
## Development setup
7+
### Requirements
8+
- docker
9+
- kubectl
10+
- kubero-cli
11+
12+
13+
### Start a cluster
14+
run a `kubero install` with the [CLI](https://github.com/kubero-dev/kubero-cli/releases/latest) and select kind. This will install a local cluster with a single node and all required components.
15+
16+
### Export the kubeconfig
17+
```bash
18+
kind export kubeconfig --name kubero-XXX --kubeconfig ./kubeconfig
19+
```
20+
21+
### Create a namespace
22+
```bash
23+
kubectl create namespace kubero-dev
24+
```
25+
26+
### configure Kubero's environment
27+
```bash
28+
mv .env.template .env
29+
```
30+
31+
### Start local node server
32+
```bash
33+
yarn install
34+
yarn dev
35+
```
36+
37+
```bash
38+
cd client
39+
npm install
40+
npm run dev
41+
```
42+
43+
If you need any additional services (Gitea, Github ...), just run `docker-compose up -d`, or add it to the `docker-compose.yml` file, if it is missing.
44+
45+
Nope. No extra database is required. All data is stored in the Kubernetes cluster.
46+
47+
## How to contribute your code
48+
49+
1. Fork the repository
50+
2. Create a new branch
51+
3. Make your changes
52+
4. Open a PR

0 commit comments

Comments
 (0)