Skip to content

Commit

Permalink
Update Readme to reflect k8s changes
Browse files Browse the repository at this point in the history
  • Loading branch information
Mtze committed Aug 13, 2024
1 parent 1537c01 commit 9bbaead
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 29 deletions.
48 changes: 19 additions & 29 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,43 +37,33 @@ HadesCI is built upon the following key components:
- You need a kubeconfig file to connect to a Kubernetes cluster.
- [Docker](https://docs.docker.com/get-docker/)
- [Docker Compose](https://docs.docker.com/compose/install/)
- [Kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
- [Minikube](https://minikube.sigs.k8s.io/docs/start/)

### Running with Docker Compose
### Running in Docker Mode

Update the `.env` file with the path to your kubeconfig file
To run HadesCI in Docker mode, follow these steps:

Start hadesci with docker-compose:
1. Copy the `.env.example` file to `.env`.
- The default is to use docker as the executor!
- Changes should not be necessary for a local test.
2. Start the HadesCI services using Docker Compose

```bash
docker-compose -f docker-compose.yml -f docker-compose.k8s.yml up -d
docker-compose -f docker-compose.yml up -d
```

## Development

### Prerequisites
### Running in Kubernetes Mode

To get started with HadesCI development, make sure you have the following prerequisites installed:
> We assume that you have a Kubernetes cluster running and a kubeconfig file to connect to it.
- [Docker](https://docs.docker.com/get-docker/)
- [Docker Compose](https://docs.docker.com/compose/install/)
- [Go](https://golang.org/doc/install)
- [Kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
- [Minikube](https://minikube.sigs.k8s.io/docs/start/)
To run HadesCI in Kubernetes mode, follow these steps:

### Running Locally
1. Copy the `.env.example` file to `.env`.
- Change the `HADES_EXECUTOR` variable to `kubernetes`.
2. Adjust the Kubeconfig volume mount in the `docker-compose.k8s.yml` file.
3. Start the HadesCI services using Docker Compose

To run HadesCI locally, follow these steps:

1. Start a local Kubernetes cluster using Minikube:

```bash
minikube start
```

2. Run HadesCI with Docker Compose:

```bash
docker-compose up
```

With these steps, you'll have a local instance of HadesCI up and running, ready for development and testing. Enjoy coding and building scalable CI solutions with HadesCI!
```bash
docker-compose -f docker-compose.yml -f docker-compose.k8s.yml up -d
```
1 change: 1 addition & 0 deletions docker-comose.k8s.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,5 @@ services:
- KUBECONFIG=/root/.kube/config
- HADES_EXECUTOR=k8s
volumes:
# Adjust this to the path of your kubeconfig file
- ./.kube/config:/root/.kube/config

0 comments on commit 9bbaead

Please sign in to comment.