Move blockchain app READMEs to centralized documentation
Some checks failed
API Endpoint Tests / test-api-endpoints (push) Successful in 10s
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 4s
Documentation Validation / validate-docs (push) Successful in 8s
Documentation Validation / validate-policies-strict (push) Successful in 4s
Integration Tests / test-service-integration (push) Successful in 38s
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 2s
P2P Network Verification / p2p-verification (push) Successful in 3s
Security Scanning / security-scan (push) Successful in 40s
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Successful in 15s
Smart Contract Tests / lint-solidity (push) Successful in 8s

- Relocate blockchain-event-bridge README content to docs/apps/blockchain/blockchain-event-bridge.md
- Relocate blockchain-explorer README content to docs/apps/blockchain/blockchain-explorer.md
- Replace app READMEs with redirect notices pointing to new documentation location
- Consolidate documentation in central docs/ directory for better organization
This commit is contained in:
aitbc
2026-04-23 12:24:48 +02:00
parent cd240485c6
commit 522655ef92
55 changed files with 7033 additions and 1536 deletions

View File

@@ -0,0 +1,206 @@
# Global Infrastructure
## Status
✅ Operational
## Overview
Global infrastructure management service for deploying, monitoring, and managing AITBC infrastructure across multiple regions and cloud providers.
## Architecture
### Core Components
- **Infrastructure Manager**: Manages infrastructure resources
- **Deployment Service**: Handles deployments across regions
- **Resource Scheduler**: Schedules resources optimally
- **Configuration Manager**: Manages infrastructure configuration
- **Cost Optimizer**: Optimizes infrastructure costs
## Quick Start (End Users)
### Prerequisites
- Python 3.13+
- Cloud provider credentials (AWS, GCP, Azure)
- Terraform or CloudFormation templates
### Installation
```bash
cd /opt/aitbc/apps/global-infrastructure
.venv/bin/pip install -r requirements.txt
```
### Configuration
Set environment variables in `.env`:
```bash
CLOUD_PROVIDER=aws
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
AWS_REGION=us-east-1
TERRAFORM_PATH=/path/to/terraform
```
### Running the Service
```bash
.venv/bin/python main.py
```
## Developer Guide
### Development Setup
1. Clone the repository
2. Create virtual environment: `python -m venv .venv`
3. Install dependencies: `pip install -r requirements.txt`
4. Configure cloud provider credentials
5. Run tests: `pytest tests/`
### Project Structure
```
global-infrastructure/
├── src/
│ ├── infrastructure_manager/ # Infrastructure management
│ ├── deployment_service/ # Deployment orchestration
│ ├── resource_scheduler/ # Resource scheduling
│ ├── config_manager/ # Configuration management
│ └── cost_optimizer/ # Cost optimization
├── terraform/ # Terraform templates
├── tests/ # Test suite
└── pyproject.toml # Project configuration
```
### Testing
```bash
# Run all tests
pytest tests/
# Run deployment tests
pytest tests/test_deployment.py
# Run cost optimizer tests
pytest tests/test_cost.py
```
## API Reference
### Infrastructure Management
#### Get Infrastructure Status
```http
GET /api/v1/infrastructure/status
```
#### Provision Resource
```http
POST /api/v1/infrastructure/provision
Content-Type: application/json
{
"resource_type": "server|database|storage",
"region": "us-east-1",
"specifications": {}
}
```
#### Decommission Resource
```http
DELETE /api/v1/infrastructure/resources/{resource_id}
```
### Deployment
#### Deploy Service
```http
POST /api/v1/infrastructure/deploy
Content-Type: application/json
{
"service_name": "blockchain-node",
"region": "us-east-1",
"configuration": {}
}
```
#### Get Deployment Status
```http
GET /api/v1/infrastructure/deployments/{deployment_id}
```
### Resource Scheduling
#### Get Resource Utilization
```http
GET /api/v1/infrastructure/resources/utilization
```
#### Optimize Resources
```http
POST /api/v1/infrastructure/resources/optimize
Content-Type: application/json
{
"optimization_type": "cost|performance",
"constraints": {}
}
```
### Configuration
#### Get Configuration
```http
GET /api/v1/infrastructure/config/{region}
```
#### Update Configuration
```http
PUT /api/v1/infrastructure/config/{region}
Content-Type: application/json
{
"parameters": {}
}
```
### Cost Management
#### Get Cost Report
```http
GET /api/v1/infrastructure/costs?period=month
```
#### Get Cost Optimization Recommendations
```http
GET /api/v1/infrastructure/costs/recommendations
```
## Configuration
### Environment Variables
- `CLOUD_PROVIDER`: Cloud provider (aws, gcp, azure)
- `AWS_ACCESS_KEY_ID`: AWS access key
- `AWS_SECRET_ACCESS_KEY`: AWS secret key
- `AWS_REGION`: Default AWS region
- `TERRAFORM_PATH`: Path to Terraform templates
- `DEPLOYMENT_TIMEOUT`: Deployment timeout in seconds
### Infrastructure Parameters
- **Regions**: Supported cloud regions
- **Instance Types**: Available instance types
- **Storage Classes**: Storage class configurations
- **Network Configurations**: VPC and network settings
## Troubleshooting
**Deployment failed**: Check cloud provider credentials and configuration.
**Resource not provisioned**: Verify resource specifications and quotas.
**Cost optimization not working**: Review cost optimizer configuration and constraints.
**Configuration sync failed**: Check network connectivity and configuration validity.
## Security Notes
- Rotate cloud provider credentials regularly
- Use IAM roles instead of access keys when possible
- Enable encryption for all storage resources
- Implement network security groups and firewalls
- Monitor for unauthorized resource changes
- Regularly audit infrastructure configuration