mirror of
https://github.com/rustfs/rustfs.git
synced 2026-05-07 23:27:50 +08:00
2f20fe9749
- Create English and Chinese README files for the openobserve-otel directory - Document configuration details for both OpenObserve and OTel Collector - Include setup instructions and application integration examples - Add badges for both OpenObserve and OpenTelemetry projects
95 lines
2.3 KiB
Markdown
95 lines
2.3 KiB
Markdown
# RustFS
|
|
|
|
## English Documentation |[中文文档](README_ZH.md)
|
|
|
|
### Prerequisites
|
|
|
|
| Package | Version | Download Link |
|
|
|---------|---------|----------------------------------------------------------------------------------------------------------------------------------|
|
|
| Rust | 1.8.5+ | [rust-lang.org/tools/install](https://www.rust-lang.org/tools/install) |
|
|
| protoc | 30.2+ | [protoc-30.2-linux-x86_64.zip](https://github.com/protocolbuffers/protobuf/releases/download/v30.2/protoc-30.2-linux-x86_64.zip) |
|
|
| flatc | 24.0+ | [Linux.flatc.binary.g++-13.zip](https://github.com/google/flatbuffers/releases/download/v25.2.10/Linux.flatc.binary.g++-13.zip) |
|
|
|
|
### Building RustFS
|
|
|
|
#### Generate Protobuf Code
|
|
|
|
```bash
|
|
cargo run --bin gproto
|
|
```
|
|
|
|
#### Using Docker for Prerequisites
|
|
|
|
```yaml
|
|
- uses: arduino/setup-protoc@v3
|
|
with:
|
|
version: "30.2"
|
|
|
|
- uses: Nugine/setup-flatc@v1
|
|
with:
|
|
version: "25.2.10"
|
|
```
|
|
|
|
#### Adding Console Web UI
|
|
|
|
1. Download the latest console UI:
|
|
```bash
|
|
wget https://dl.rustfs.com/artifacts/console/rustfs-console-latest.zip
|
|
```
|
|
2. Create the static directory:
|
|
```bash
|
|
mkdir -p ./rustfs/static
|
|
```
|
|
3. Extract and compile RustFS:
|
|
```bash
|
|
unzip rustfs-console-latest.zip -d ./rustfs/static
|
|
cargo build
|
|
```
|
|
|
|
### Running RustFS
|
|
|
|
#### Configuration
|
|
|
|
Set the required environment variables:
|
|
|
|
```bash
|
|
# Basic config
|
|
export RUSTFS_VOLUMES="./target/volume/test"
|
|
export RUSTFS_ADDRESS="0.0.0.0:9000"
|
|
export RUSTFS_CONSOLE_ENABLE=true
|
|
export RUSTFS_CONSOLE_ADDRESS="0.0.0.0:9001"
|
|
|
|
# Observability config
|
|
export RUSTFS_OBS_ENDPOINT="http://localhost:4317"
|
|
|
|
# Event message configuration
|
|
#export RUSTFS_EVENT_CONFIG="./deploy/config/event.toml"
|
|
|
|
```
|
|
|
|
#### Start the service
|
|
|
|
```bash
|
|
./rustfs /data/rustfs
|
|
```
|
|
|
|
### Observability Stack
|
|
|
|
#### Deployment
|
|
|
|
1. Navigate to the observability directory:
|
|
```bash
|
|
cd .docker/observability
|
|
```
|
|
|
|
2. Start the observability stack:
|
|
```bash
|
|
docker compose -f docker-compose.yml up -d
|
|
```
|
|
|
|
#### Access Monitoring Dashboards
|
|
|
|
- Grafana: `http://localhost:3000` (credentials: `admin`/`admin`)
|
|
- Jaeger: `http://localhost:16686`
|
|
- Prometheus: `http://localhost:9090`
|