Percona Everest installation and workflow¶
This section provides an overview of how Percona Everest is installed, the components involved, and the workflow, from operator installation to database provisioning, backups, and restores.
Percona Everest installation workflow¶
Starting from Percona Everest v1.4.0, the CLI installation is a wrapper around the helm charts (everest-core and everest-db-namespace){:target=”_blank”}. The installation flow is as follows:
-
The
everest-core
helm chart is installed:This step deploys the core components required for Percona Everest:
-
OLM Components** are deployed into the
everest-olm
namespace, which includes:- olm-operator
- catalog-operator
- package-server
- everest-catalog
-
Monitoring Stack is deployed into the
everest-monitoring
namespace, which includes:- vm-operator
- kube-state-metrics
-
Everest Components are deployed into the
everest-system
namespace, which includes:- everest-server
- everest-operator
-
-
The
everest-db-namespace
chart is installed in the everest namespace. This chart handles the deployment of database operators using the following workflow:- Creates OLM subscriptions for each of the selected database operators (by default, all supported operators are selected).
- OLM reconciles the subscriptions and creates an install plan for each operator.
- A Helm hook creates the
everest-operators-installer
job that waits for the OLM install plan to be created and approves it once created. - OLM reconciles the approved install plan and creates a
cluster-service-version
for each database operator. The CSV includes all the manifests needed to install the operator. OLM automatically applies these manifests, and the operator is installed.
Configurable options¶
The database operator namespaces and the operators that get installed can be configured as follows:
- By default, the
everest
namespace is used, and all the database operators (PXC, PSMDB, and PG) are installed. - You can skip the database namespace creation step by using the
--skip-db-namespace
flag. -
To specify one or more custom namespaces, use the
--namespaces
flag.You can provision multiple database namespaces simultaneously by providing a comma-separated list with the
--namespaces
flag. For example:everestctl install --namespaces n1,n2
-
If you want to skip the installation of certain operators, you can use the following flags:
--operator.mongodb=false
--operator.postgresql=false
--operator.xtradb-cluster=false
Manage namespaces¶
You can manage database namespaces after the initial installation using the following commands:
everestctl namespaces add [NAMESPACE]
everestctl namespaces update [NAMESPACE]
everestctl namespaces remove [NAMESPACE]
For detailed information on managing namespaces, see the Namespaces management section.
The helm installation method provides an identical flow to the one described above, with similar configuration options.
Refer to the helm chart documentation for a full list of available configuration options.
Percona Everest server and operator workflow¶
Database creation workflow¶
Here’s the database creation workflow in Percona Everest:
- The Percona Everest user is authenticated and logged in and a JWT Token is provided.
- The user creates a database, either through the frontend UI or
everestctl
or via the APl. - The Percona Everest API is invoked to create a create a Custom Resource Definition (CRD). The Percona Everest server then creates a custom resource
DatabaseCluster
. - In the
everest-operator
reconciliation loop, once theDatabaseCluster
object is recognized, an appropriate custom resource for the database is created, for example if it’s PXC ,PerconaXtraDBCluster
is created. -
The database operator takes over the task of creating the database and the necessary objects to manage it.
Note
Other actions, such as creating backups, restores ,monitoring or deleting the objects follows a similar flow except the objects involved may differ.
All the custom resources connected to Percona Everest follow a similar flow except the
DatabaseEngine
.
Database engine workflow¶
Here’s the workflow for the database engine in Percona Everest:
- The user installs the everest db namespace chart either as part of initial installation or as a separate step.
- Subscriptions are created for the operators chosen while installing the helm chart.
- OLM reconciles the Subscriptions and creates an InstallPlan.
- The helm chart creates a kubernetes job called e
verest-operators-installer
that waits for the InstallPlan to be created and approves it. - OLM detects that the InstallPlan has been approved and creates a
ClusterServiceVersion
, deploying all components that make up the database operator. - The Percona Everest operator detects the deployment resource of the database operator and reconciles the DatabaseEngine CR of the corresponding type. During the reconciliation process, the everest operator detects the installed version and queries Percona’s Version Service.
Check Percona.com to get the engine versions supported by that operator. For example, mongod versions supported by PSMDBO v1.19.0.
Get expert help¶
If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.