Migrate OpenSearch management to Nais Console¶
This guide will help you migrate an existing OpenSearch instance to instead be managed via Nais Console.
Prerequisites¶
Before we begin, ensure that:
- You're part of a Nais team
- You have set up command-line access
- You have an existing OpenSearch instance
Steps¶
1. Verify that your existing OpenSearch settings are compatible with Console¶
Before migrating, ensure that your existing OpenSearch instance is compatible with Nais Console.
Console currently supports the following fields:
.spec.plan
- plan is now split into size and tiersize
denotes the memory size of the instancetier
denotes the availability tier of the instanceSINGLE_NODE
(equivalent tostartup-*
, orhobbyist
for the smallestsize
)HIGH_AVAILABILITY
(equivalent tobusiness-*
)
- For example, if your existing plan is
startup-4
, you would set:size = "RAM_4GB"
tier = "SINGLE_NODE"
- If your existing plan is
business-16
, you would set:size = "RAM_16GB"
tier = "HIGH_AVAILABILITY"
- If your existing plan is
hobbyist
, you would set:size = "RAM_2GB"
tier = "SINGLE_NODE"
.spec.userConfig.opensearch_version
.spec.project
(automatically set).spec.terminationProtection
(automatically enabled)
If you need other fields not supported by Console, reach out to the Nais team.
2. Delete OpenSearch manifest from your Git repository¶
Your Git repository might have a manifest file that was used to create the OpenSearch instance. It should look something like this:
-apiVersion: aiven.io/v1alpha1
-kind: OpenSearch
-metadata:
- labels:
- app: opensearch-tester
- team: myteam
- name: opensearch-myteam-tester
- namespace: myteam
-spec:
- plan: startup-4
- project: nav-dev
Delete the file from your repository.
3. Remove references from GitHub Actions workflows¶
If you have any GitHub Actions workflows that references the OpenSearch manifest file you just deleted, you should remove those references:
name: Build and deploy
on: [...]
jobs:
build-and-deploy:
...
steps:
...
- uses: nais/deploy/actions/deploy@v2
env:
- RESOURCE: .nais/app.yaml,.nais/opensearch.yaml
+ RESOURCE: .nais/app.yaml
...
``
4. Patch resource in Kubernetes¶
To allow Console to take over management of the OpenSearch instance, you need to add a label to the existing OpenSearch resource in your Kubernetes cluster.
To do so, run the following command:
kubectl label opensearch $OPENSEARCH_NAME nais.io/managed-by=console \
--namespace $TEAM \
--context $ENVIRONMENT
where
$OPENSEARCH_NAME
is the fully qualified name of your OpenSearch instance, e.g.opensearch-<TEAM>-<INSTANCE>
.$TEAM
is your team.$ENVIRONMENT
is the name of the environment you're targeting.
5. Finishing up¶
- Visit Nais Console.
- Navigate to your team.
- Navigate to the OpenSearch overview in the sidebar.
- Verify that you can see the OpenSearch instance without the prefix
opensearch-<TEAM>-
in its name. - Click the OpenSearch instance to view its details.
- Verify that you can Edit or Delete the OpenSearch instance.
Congratulations! You've now successfully migrated your OpenSearch instance to be managed via Nais Console.