30810eecd7
Some checks failed
Create issues from TODOs / todos (push) Failing after 3s
Close inactive issues / close-issues (push) Has been cancelled
Deploy GitHub Pages / deploy-preview (push) Has been cancelled
CI / ⚙️ Variables Setup (push) Has been cancelled
CI / ⚙️ Test Guard (push) Has been cancelled
CI / 🚀 Notify external services - draft (push) Has been cancelled
CI / 📦 Build Packages (push) Has been cancelled
CI / 📦 Meteor Build (coverage) (push) Has been cancelled
CI / 📦 Meteor Build (production) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [account-service presence-service omnichannel-transcript-service], ${{ (github.event_name != 'release' && github.ref != 'refs/heads/develop') && 'coverage' || 'production' }}) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [account-service presence-service omnichannel-transcript-service], fips) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [authorization-service queue-worker-service ddp-streamer-service], ${{ (github.event_name != 'release' && github.ref != 'refs/heads/develop') && 'coverage' || 'production' }}) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [authorization-service queue-worker-service ddp-streamer-service], fips) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [rocketchat], ${{ (github.event_name != 'release' && github.ref != 'refs/heads/develop') && 'coverage' || 'production' }}) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [rocketchat], coverage) (push) Has been cancelled
CI / 🚢 Build Docker (amd64, [rocketchat], fips) (push) Has been cancelled
CI / 🚢 Build Docker (arm64, [account-service presence-service omnichannel-transcript-service], ${{ (github.event_name != 'release' && github.ref != 'refs/heads/develop') && 'coverage' || 'production' }}) (push) Has been cancelled
CI / 🚢 Build Docker (arm64, [authorization-service queue-worker-service ddp-streamer-service], ${{ (github.event_name != 'release' && github.ref != 'refs/heads/develop') && 'coverage' || 'production' }}) (push) Has been cancelled
CI / 🚢 Build Docker (arm64, [rocketchat], ${{ (github.event_name != 'release' && github.ref != 'refs/heads/develop') && 'coverage' || 'production' }}) (push) Has been cancelled
CI / 🚢 Build Docker (arm64, [rocketchat], coverage) (push) Has been cancelled
CI / 🚢 Publish Docker Images (ghcr.io) (push) Has been cancelled
CI / 📦 Track Image Sizes (push) Has been cancelled
CI / 🔎 Code Check - Action Lint (push) Has been cancelled
CI / 🔎 Code Check (push) Has been cancelled
CI / 🔨 Test Storybook (push) Has been cancelled
CI / 🔨 Test Unit (push) Has been cancelled
CI / 🔨 Test API (CE) (push) Has been cancelled
CI / 🔨 Test API Livechat (CE) (push) Has been cancelled
CI / 🔨 Test UI (CE) (push) Has been cancelled
CI / 🔨 Test API (EE) (push) Has been cancelled
CI / 🔨 Test API Livechat (EE) (push) Has been cancelled
CI / 🔨 Test API Apps (deno-runtime - EE) (push) Has been cancelled
CI / 🔨 Test UI (EE) (push) Has been cancelled
CI / 🔨 Test API (FIPS) (push) Has been cancelled
CI / 🔨 Test API Livechat (FIPS) (push) Has been cancelled
CI / 🔨 Test UI (FIPS) (push) Has been cancelled
CI / 🔨 Test Federation Matrix (push) Has been cancelled
CI / 📊 Report Coverage (push) Has been cancelled
CI / ✅ Tests Done (push) Has been cancelled
CI / 🚀 Publish build assets (push) Has been cancelled
CI / 🚀 Publish Docker Images (DockerHub) (push) Has been cancelled
CI / 🚀 Notify external services (push) Has been cancelled
CI / Update Version Durability (push) Has been cancelled
Release / Release (push) Has been cancelled
Auto-close duplicate issues / auto-close-duplicates (push) Failing after 1s
Code scanning - action / CodeQL-Build (push) Failing after 1s
77 lines
2.0 KiB
Markdown
77 lines
2.0 KiB
Markdown
# Federation Matrix
|
|
|
|
Rocket.Chat's Matrix federation integration package for cross-platform communication.
|
|
|
|
## Integration Tests
|
|
|
|
### Setup
|
|
|
|
Before running integration tests, add the following entries to your `/etc/hosts` file:
|
|
|
|
```
|
|
127.0.0.1 element
|
|
127.0.0.1 hs1
|
|
127.0.0.1 rc1
|
|
```
|
|
|
|
### How It Works
|
|
|
|
The integration test script builds Rocket.Chat locally, starts federation services (Rocket.Chat, Synapse, MongoDB), waits for all services to be ready, then runs end-to-end tests. The script automatically handles cleanup unless you specify otherwise.
|
|
|
|
### Available Flags
|
|
|
|
- **No flags (default)**: Builds local code and runs tests
|
|
- `--image [IMAGE]`: Uses a pre-built Docker image instead of building locally (defaults to `rocketchat/rocket.chat:latest` if no image specified)
|
|
- `--keep-running`: Keeps containers running after tests complete for manual validation
|
|
- `--element`: Includes Element web client in the test environment
|
|
- `--no-test`: Starts containers and skips running tests (useful for manual testing or debugging)
|
|
|
|
### Usage Examples
|
|
|
|
**Basic local testing:**
|
|
```bash
|
|
yarn test:integration
|
|
```
|
|
|
|
**Test with pre-built image:**
|
|
```bash
|
|
yarn test:integration --image
|
|
```
|
|
|
|
**Test with specific pre-built image:**
|
|
```bash
|
|
yarn test:integration --image rocketchat/rocket.chat:latest
|
|
```
|
|
|
|
**Keep services running for manual inspection:**
|
|
```bash
|
|
yarn test:integration --keep-running
|
|
```
|
|
|
|
**Run with Element client:**
|
|
```bash
|
|
yarn test:integration --element
|
|
```
|
|
|
|
**Start containers only (skip tests):**
|
|
```bash
|
|
yarn test:integration --no-test
|
|
```
|
|
|
|
**Start containers with Element and keep them running (skip tests):**
|
|
```bash
|
|
yarn test:integration --keep-running --element --no-test
|
|
```
|
|
|
|
**Combine flags:**
|
|
```bash
|
|
yarn test:integration --image rocketchat/rocket.chat:latest --keep-running --element
|
|
```
|
|
|
|
### Service URLs (when using --keep-running or --no-test)
|
|
|
|
- **Rocket.Chat**: https://rc1
|
|
- **Synapse**: https://hs1
|
|
- **MongoDB**: localhost:27017
|
|
- **Element**: https://element (when using --element flag)
|