Skip to content

Commit

Permalink
Update docs and add links to docs.gen3.org
Browse files Browse the repository at this point in the history
  • Loading branch information
jawadqur committed Jul 11, 2024
1 parent f08535b commit c8c7589
Show file tree
Hide file tree
Showing 5 changed files with 7 additions and 269 deletions.
6 changes: 3 additions & 3 deletions .secrets.baseline
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"files": "^.secrets.baseline$",
"lines": null
},
"generated_at": "2024-07-02T16:36:02Z",
"generated_at": "2024-07-11T17:28:47Z",
"plugins_used": [
{
"name": "AWSKeyDetector"
Expand Down Expand Up @@ -63,7 +63,7 @@
"hashed_secret": "64ab0c1d3edc1c8c166351207b840ac7b2a90523",
"is_secret": false,
"is_verified": false,
"line_number": 87,
"line_number": 59,
"type": "Secret Keyword"
}
],
Expand All @@ -88,7 +88,7 @@
"hashed_secret": "ac0fedaac180de6bd70a97b711692a92dade479e",
"is_secret": false,
"is_verified": false,
"line_number": 94,
"line_number": 92,
"type": "Secret Keyword"
}
],
Expand Down
65 changes: 2 additions & 63 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,9 @@ helm repo update
helm upgrade --install gen3 gen3/gen3 -f ./values.yaml
```

Assuming you already have the [prerequisites](./docs/PREREQUISITES.md) installed and configured, you can deploy Gen3 with the helm command.
For more information on how to deploy Gen3 with helm, please see the [Gen3 Example Deployment Guide](https://docs.gen3.org/docs/Deployment/Example%20Deployment)


> **Warning**
> The default Helm chart configuration is not intended for production. The default chart creates a proof of concept (PoC) implementation where all Gen3 services are deployed in the cluster, including postgres and elasticsearch. For production deployments, you must follow the [Production/Cloud Native/Hybrid architecture](./docs/PRODUCTION.md)

For a production deployment, you should have strong working knowledge of Kubernetes. This method of deployment has different management, observability, and concepts than traditional deployments.

In a production deployment:

- The stateful components, like PostgreSQL or Elasticsearch, must run outside the cluster on PaaS or compute instances. This configuration is required to scale and reliably service the variety of workloads found in production Gen3 environments.

- You should use Cloud PaaS for PostgreSQL, Elasticsearch, and object storage.
https://docs.gen3.org


## Configuration
Expand Down Expand Up @@ -56,23 +45,6 @@ fence:
```



## Selective deployments
All gen3 services are sub-charts of the gen3 chart (which acts as an umbrella chart).

For your specific installation of gen3, you may not require all our services.


To enable or disable a service you can use this pattern in your `values.yaml`

```yaml
fence:
enabled: true

wts:
enabled: false
```
## Gen3 Login Options
Gen3 does not have any IDP, but can integrate with many. We will cover Google login here, but refer to the fence documentation for additional options.

Expand Down Expand Up @@ -108,39 +80,6 @@ For `"Authorized redirect URIs"` add `https://<hostname>/user/login/google/logi

After configuration is complete, take note of the client ID that was created. You will need the client ID and client secret to complete the next steps.

# Production deployments
Please read [this](./docs/PRODUCTION.md) for more details on production deployments.
NOTE: Gen3 helm charts are currently not used in production by CTDS, but we are aiming to do that soon and will have additional documentation on that.
# Local Development
For local development you must be connected to a kubernetes cluster. As referenced above in the section `Kubernetes cluster` we recommend using [Rancher Desktop](https://rancherdesktop.io/) as Kubernetes on your local machine, especially on M1 Mac's. You also get ingress and other benefits out of the box.
For MacOS users, [Minikube](https://minikube.sigs.k8s.io/docs/start/) equipped with the ingress addon serves as a viable alternative to Rancher Desktop. On Linux, we've observed that using [Kind](https://kind.sigs.k8s.io/) with an NGINX ingress installed often provides a more seamless experience compared to both Rancher Desktop and Minikube. Essentially, Helm requires access to a Kubernetes cluster with ingress capabilities, facilitating the loading of the portal in your browser for an optimal development workflow.
To install the NGINX ingress:
```
helm repo add nginx-stable https://helm.nginx.com/stable
helm repo update
kubectl create ns nginx-ingress
helm install nginx-ingress nginx-stable/nginx-ingress --namespace nginx-ingress
```
> **Warning**
> If you are using Rancher Desktop you need to increase the vm.max_map_count as outlined [here](https://docs.rancherdesktop.io/how-to-guides/increasing-open-file-limit/)
> If you are using Minikube you will need to enabled the ingress addon as outlined [here](https://kubernetes.io/docs/tasks/access-application-cluster/ingress-minikube/)
1. Clone the repository
2. Navigate to the `gen3-helm/helm/gen3` directory and run `helm dependency update`
3. Navigate to the back to the `gen3-helm` directory and create your values.yaml file. See the `TL;DR` section for a minimal example.
4. Run `helm upgrade --install gen3 ./helm/gen3 -f ./values.yaml`
## Using Skaffold
Skaffold is a tool for local development that can be used to automatically rebuild and redeploy your application when changes are detected. A minimal skaffold.yaml configuration file has been provided in the gen3-helm directory. Update the values of this file to match your needs.
Follow the steps above, but instead of doing the helm upgrade --install step, use `skaffold dev` to start the development process. Skaffold will automatically build and deploy your application to your kubernetes cluster.

# Troubleshooting

Expand Down
2 changes: 1 addition & 1 deletion docs/INGRESS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Ingress in Gen3

# Dev
if `global.dev` is set to true, a very basic ingress is created, that works out of the box with `traefik` service that is included in `Rancher-Desktop`
if `global.dev` is set to true, a very basic ingress is created.

# AWS

Expand Down
4 changes: 1 addition & 3 deletions docs/PREREQUISITES.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,7 @@ Before deploying the Gen3 application using Helm, ensure that the following prer
## Prerequisites

### Kubernetes cluster
Any kubernetes cluster _should_ work. We are testing with EKS, AKS, GKE and Rancher Desktop.

It is suggested to use [Rancher Desktop](https://rancherdesktop.io/) as Kubernetes on your laptop, especially on M1 Mac's. You also get ingress and other benefits out of the box.
Any kubernetes cluster _should_ work. We are testing with EKS, AKS, GKE.


### Postgres
Expand Down
199 changes: 0 additions & 199 deletions docs/gen3_developer_environments.md

This file was deleted.

0 comments on commit c8c7589

Please sign in to comment.