839133fc27
* docs: add guides to view middleware data * docs: add guide for grafana * docs: add guide for otel and integration guides for other middleware * docs: add guide for elasticsearch * docs: update based on suggestions * Update zh.ts * docs: update content * docs: resolve conflict
83 lines
3.1 KiB
Markdown
83 lines
3.1 KiB
Markdown
---
|
|
outline: [2, 3]
|
|
description: Learn how to view and manage MongoDB data in Olares using CLI or Bytebase.
|
|
---
|
|
# View MongoDB data
|
|
|
|
To use MongoDB in Olares, install it from Market first. This guide walks you through the installation steps and shows how to access it from Olares.
|
|
|
|
## Install MongoDB service
|
|
|
|
Before connecting, install the MongoDB service from Market.
|
|
1. Open Market from the Launchpad and search for "MongoDB".
|
|
2. Click **Get**, then **Install**, and wait for the installation to complete.
|
|
|
|
Once installed, the service and its connection details will appear in the Middleware list in Control Hub.
|
|
|
|
## Get connection information
|
|
|
|
Before connecting, obtain MongoDB connection details from the Control Hub.
|
|
|
|
1. Open Control Hub from Launchpad.
|
|
2. In the left navigation pane, go to Middleware and select **Mongodb**.
|
|
3. On the Details panel, record the following information:
|
|
- **Mongos**: The host address provided by Control Hub. Used for Bytebase connection.
|
|
- **User**: Used for Bytebase connection.
|
|
- **Password**: Used for both CLI and Bytebase.
|
|
|
|
{width=60% style="margin-left:0"}
|
|
|
|
## Access via CLI
|
|
|
|
You can use the Olares terminal to access the MongoDB container.
|
|
|
|
1. In Control Hub, open the Olares terminal at the bottom of the left navigation pane.
|
|
2. Retrieve the Pod name for the middleware:
|
|
|
|
```bash
|
|
kubectl get pods -n os-platform | grep tapr-middleware
|
|
```
|
|
3. Record the Pod name that starts with `tapr-middleware`, then enter the container:
|
|
|
|
```bash
|
|
kubectl exec -it -n os-platform <tapr-middleware-pod> -- sh
|
|
```
|
|
4. Connect to MongoDB using `mongosh`:
|
|
|
|
```bash
|
|
mongosh "mongodb://root:<your password from controlhub>@mongodb-mongodb-headless.mongodb-middleware:27017"
|
|
```
|
|
|
|
## Manage via Bytebase
|
|
|
|
Bytebase provides a graphical interface for database management and schema changes.
|
|
|
|
### Install Bytebase
|
|
|
|
1. Open Market and search for "Bytebase".
|
|
2. Click **Get**, then **Install**.
|
|
|
|
### First-time setup
|
|
|
|
When launching Bytebase for the first time, you must configure an administrator account.
|
|
|
|
:::tip
|
|
Remember these credentials. Only the admin account can create new database instances.
|
|
:::
|
|
|
|
1. Open Bytebase from Launchpad.
|
|
2. Follow the on-screen prompts to set up your admin account with email and password.
|
|
|
|
### Create a MongoDB instance
|
|
|
|
1. Log in to Bytebase with your admin account.
|
|
2. In the left navigation pane, select **Instances**, then click **+ Add Instance**.
|
|
3. Choose **MongoDB** as the database type.
|
|
4. Fill in the connection fields using values from Control Hub:
|
|
- **Host or Socket**: Enter the **Mongos** host address and do not include the port.
|
|
- **Port**: Keep the default, usually `27017`.
|
|
- **Username**: Enter the **User** value from Control Hub.
|
|
- **Password**: Enter the **Password** value from Control Hub.
|
|
5. Click **Test Connection** to verify connectivity, then click **Create**.
|
|
|
|
Creating an instance in Bytebase does not create a new database. Once the instance is created, you can use the corresponding client tools to inspect and manage data. |