Skip to content
This repository has been archived by the owner on Mar 4, 2024. It is now read-only.

Commit

Permalink
EVEREST-574 Updated README (#311)
Browse files Browse the repository at this point in the history
  • Loading branch information
gen1us2k authored Nov 16, 2023
1 parent f3f3d38 commit 9c63b86
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 31 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,7 @@ jobs:
kind: Secret
apiVersion: v1
metadata:
name: pmm-local-secret
name: pmm-local
namespace: percona-everest
type: Opaque
stringData:
Expand All @@ -322,7 +322,7 @@ jobs:
namespace: percona-everest
spec:
type: pmm
credentialsSecretName: pmm-local-secret
credentialsSecretName: pmm-local
pmm:
url: http://localhost
image: percona/pmm-client:2
Expand Down
41 changes: 12 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,32 +13,12 @@ You must have a publicly accessible Kubernetes cluster to use Everest. EKS or GK

## Getting started

The Percona Everest has two primary components that assist you in creating the environment:

1. [CLI](https://github.com/percona/percona-everest-cli), which installs Everest's required components.
2. Backend, which installs DBaaS features.

To start using Everest, use the following commands:

```sh
export SECRETS_ROOT_KEY=$(openssl rand -base64 32)
echo "$SECRETS_ROOT_KEY"
```
This generates a base64-encoded 256-bit key used for secrets encryption. Make
sure to securely store this key, without it everest won't be able to access the
secrets stored in its internal secrets storage.

```sh
wget https://raw.githubusercontent.com/percona/percona-everest-backend/main/deploy/quickstart-compose.yml
docker compose -f quickstart-compose.yml up -d
```
This will spin up the backend/frontend, accessible at http://127.0.0.1:8080.

The Percona Everest has [CLI](https://github.com/percona/percona-everest-cli), which installs Everest's required components.


### Everest provisioning

1. Download the latest release of [everestctl](https://github.com/percona/percona-everest-cli/releases) command for your operating system
1. Download the latest release of [everestctl](https://github.com/percona/percona-everest-cli/releases) command for your operating system

2. Modify the permissions of the file:

Expand All @@ -49,24 +29,27 @@ This will spin up the backend/frontend, accessible at http://127.0.0.1:8080.
3. Run the following command to install all the required operators in headless mode:

```sh
./everestctl-darwin-amd64 install operators --backup.enable=false --everest.endpoint=http://127.0.0.1:8080 --monitoring.enable=false --operator.mongodb=true --operator.postgresql=true --operator.xtradb-cluster=true --skip-wizard
./everestctl-darwin-amd64 install --monitoring.enable=false --operator.mongodb=true --operator.postgresql=true --operator.xtradb-cluster=true --skip-wizard
```

Alternatively, use the wizard to run it:

✗ ./everestctl install operators
? Everest URL http://127.0.0.1:8080
? Choose your Kubernetes Cluster name k3d-everest-dev
? Do you want to enable monitoring? No
? Do you want to enable backups? No
? What operators do you want to install? MySQL, MongoDB, PostgreSQL
```
Once provisioning is complete, you can visit http://127.0.0.1:8080 to create your first database cluster!
Once provisioning is complete, you can expose your everest installation using the following command
```
kubectl port-forward -n percona-everest deployment/percona-everest 8080:8080
```
You can visit http://127.0.0.1:8080 to create your first database cluster!
## Known limitations
- Currently, Everest only allows for the basic creation of database clusters without monitoring integration or backup/restore support. However, we will be adding this functionality in the near future.
- It is possible to register multiple Kubernetes clusters, but the user interface only supports one.
- There are no authentication or access control features, but you can integrate Everest with your existing solution.
* [Ambassador](https://github.com/datawire/ambassador) via
[auth service](https://www.getambassador.io/reference/services/auth-service)
Expand Down

0 comments on commit 9c63b86

Please sign in to comment.