aitbc1
bfe6f94b75
Some checks failed
AITBC CI/CD Pipeline / lint-and-test (3.11) (push) Has been cancelled
AITBC CI/CD Pipeline / lint-and-test (3.12) (push) Has been cancelled
AITBC CI/CD Pipeline / lint-and-test (3.13) (push) Has been cancelled
AITBC CI/CD Pipeline / test-cli (push) Has been cancelled
AITBC CI/CD Pipeline / test-services (push) Has been cancelled
AITBC CI/CD Pipeline / test-production-services (push) Has been cancelled
AITBC CI/CD Pipeline / security-scan (push) Has been cancelled
AITBC CI/CD Pipeline / build (push) Has been cancelled
AITBC CI/CD Pipeline / deploy-staging (push) Has been cancelled
AITBC CI/CD Pipeline / deploy-production (push) Has been cancelled
AITBC CI/CD Pipeline / performance-test (push) Has been cancelled
AITBC CI/CD Pipeline / docs (push) Has been cancelled
AITBC CI/CD Pipeline / release (push) Has been cancelled
AITBC CI/CD Pipeline / notify (push) Has been cancelled
Security Scanning / Bandit Security Scan (apps/coordinator-api/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (cli/aitbc_cli) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-core/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-crypto/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-sdk/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (tests) (push) Has been cancelled
Security Scanning / CodeQL Security Analysis (javascript) (push) Has been cancelled
Security Scanning / CodeQL Security Analysis (python) (push) Has been cancelled
Security Scanning / Dependency Security Scan (push) Has been cancelled
Security Scanning / Container Security Scan (push) Has been cancelled
Security Scanning / OSSF Scorecard (push) Has been cancelled
Security Scanning / Security Summary Report (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.11) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.12) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.13) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-summary (push) Has been cancelled
- Remove debugging service documentation (DEBUgging_SERVICES.md) - Remove development logs policy and quick reference guides - Remove E2E test creation summary - Remove gift certificate example file - Remove GitHub pull summary documentation
86 lines
2.9 KiB
Markdown
86 lines
2.9 KiB
Markdown
# AITBC Service Naming Convention
|
|
|
|
## Updated Service Names (2026-02-13)
|
|
|
|
All AITBC systemd services now follow the `aitbc-` prefix convention for consistency and easier management.
|
|
|
|
### Site A (aitbc.bubuit.net) - Production Services
|
|
|
|
| Old Name | New Name | Port | Description |
|
|
|----------|----------|------|-------------|
|
|
| blockchain-node.service | aitbc-blockchain-node-1.service | 8081 | Blockchain Node 1 |
|
|
| blockchain-node-2.service | aitbc-blockchain-node-2.service | 8082 | Blockchain Node 2 |
|
|
| blockchain-rpc.service | aitbc-blockchain-rpc-1.service | - | RPC API for Node 1 |
|
|
| blockchain-rpc-2.service | aitbc-blockchain-rpc-2.service | - | RPC API for Node 2 |
|
|
| coordinator-api.service | aitbc-coordinator-api.service | 8000 | Coordinator API |
|
|
| exchange-mock-api.service | aitbc-exchange-mock-api.service | - | Exchange Mock API |
|
|
|
|
### Site B (ns3 container) - Remote Node
|
|
|
|
| Old Name | New Name | Port | Description |
|
|
|----------|----------|------|-------------|
|
|
| blockchain-node.service | aitbc-blockchain-node-3.service | 8082 | Blockchain Node 3 |
|
|
| blockchain-rpc.service | aitbc-blockchain-rpc-3.service | - | RPC API for Node 3 |
|
|
|
|
### Already Compliant Services
|
|
These services already had the `aitbc-` prefix:
|
|
- aitbc-exchange-api.service (port 3003)
|
|
- aitbc-exchange.service (port 3002)
|
|
- aitbc-miner-dashboard.service
|
|
|
|
### Removed Services
|
|
- aitbc-blockchain.service (legacy, was on port 9080)
|
|
|
|
## Management Commands
|
|
|
|
### Check Service Status
|
|
```bash
|
|
# Site A (via SSH)
|
|
ssh aitbc "systemctl status aitbc-blockchain-node-1.service"
|
|
|
|
# Site B (via SSH)
|
|
ssh ns3-root "incus exec aitbc -- systemctl status aitbc-blockchain-node-3.service"
|
|
```
|
|
|
|
### Restart Services
|
|
```bash
|
|
# Site A
|
|
ssh aitbc "systemctl restart aitbc-blockchain-node-1.service"
|
|
|
|
# Site B
|
|
ssh ns3-root "incus exec aitbc -- systemctl restart aitbc-blockchain-node-3.service"
|
|
```
|
|
|
|
### View Logs
|
|
```bash
|
|
# Site A
|
|
ssh aitbc "journalctl -u aitbc-blockchain-node-1.service -f"
|
|
|
|
# Site B
|
|
ssh ns3-root "incus exec aitbc -- journalctl -u aitbc-blockchain-node-3.service -f"
|
|
```
|
|
|
|
## Service Dependencies
|
|
|
|
### Blockchain Nodes
|
|
- Node 1: `/opt/blockchain-node` → port 8081
|
|
- Node 2: `/opt/blockchain-node-2` → port 8082
|
|
- Node 3: `/opt/blockchain-node` → port 8082 (Site B)
|
|
|
|
### RPC Services
|
|
- RPC services are companion services to the main nodes
|
|
- They provide HTTP API endpoints for blockchain operations
|
|
|
|
### Coordinator API
|
|
- Main API for job submission, miner management, and receipts
|
|
- Runs on localhost:8000 inside container
|
|
- Proxied via nginx at https://aitbc.bubuit.net/api/
|
|
|
|
## Benefits of Standardized Naming
|
|
|
|
1. **Clarity**: Easy to identify AITBC services among system services
|
|
2. **Management**: Simpler to filter and manage with wildcards (`systemctl status aitbc-*`)
|
|
3. **Documentation**: Consistent naming across all documentation
|
|
4. **Automation**: Easier scripting and automation with predictable names
|
|
5. **Debugging**: Faster identification of service-related issues
|