homelab infrastructure services

Update deployment_strategy.md: SSEP→SMEP, service→machine registry

- Changed UID scheme name from SSEP to SMEP
- Updated SS (Service) to M (Machine) throughout
- Renamed Service Registry section to Machine Registry
- Updated registry paths from service-registry to machine-registry
- Updated port allocation table headers

+19 -19
+19 -19
docs/deployment_strategy.md
··· 13 13 14 14 ## UID Convention 15 15 16 - All Docker service users follow a 5-digit UID scheme called **SSEP**: 16 + All Docker machine users follow a 5-digit UID scheme called **SMEP**: 17 17 18 - **S-SS-E-P** where each digit represents: 18 + **S-M-E-P** where each digit represents: 19 19 20 20 - **S** (Sheet): `1-5` = Sheet number (dynamically calculated from sheet name) 21 - - **SS** (Service): `00-99` = Service number within the sheet (2-digit) 21 + - **M** (Machine): `00-99` = Machine number within the sheet (2-digit) 22 22 - **E** (Environment): `0-9` = Environment number (expanded from 2 to 10 environments) 23 23 - **P** (Port Index): `0-9` = Port index, incremented for additional ports 24 24 25 - ### SSEP Implementation 25 + ### SMEP Implementation 26 26 27 27 The UID is calculated during `machine/setup.sh` based on the inputs: 28 28 29 29 ```bash 30 30 # Example: ./machine/setup.sh gazette prod DS412plus 31 - TIN_SERVICE_UID=$(calculate_service_uid "gazette" "prod") 32 - # Result: 10100 (S=1, SS=01, E=0, P=0) 31 + TIN_SERVICE_UID=$(calculate_machine_uid "gazette" "prod") 32 + # Result: 10100 (S=1, M=01, E=0, P=0) 33 33 ``` 34 34 35 - **Service Number Mapping (SS digits):** 35 + **Machine Number Mapping (M digits):** 36 36 - `00` = station (sheet infrastructure: registry, shared config) 37 - - `01` = gazette (first service) 37 + - `01` = gazette (first machine) 38 38 - `02` = lldap (identity management) 39 - - `03` = gateway (gateway service) 40 - - `04-99` = Additional services (auto-assigned or manually configured) 39 + - `03` = gateway (gateway machine) 40 + - `04-99` = Additional machines (auto-assigned or manually configured) 41 41 42 42 **Port Allocation from UID:** 43 43 The same UID serves as the base port number. Additional ports increment the P digit: ··· 112 112 - `10180` = gazette-canary (E:8) 113 113 - `10190` = gazette-local (E:9) 114 114 115 - ## Sheet Station (SS=00) 115 + ## Sheet Station (M=00) 116 116 117 - The sheet station (SS=00) provides infrastructure services for the sheet: 117 + The sheet station (M=00) provides infrastructure services for the sheet: 118 118 119 - ### Service Registry 120 - Located at `/volume1/{sheet}/station/prod/service-registry`, this file maps service names to numbers in the example form: 119 + ### Machine Registry 120 + Located at `/volume1/{sheet}/station/prod/machine-registry`, this file maps machine names to numbers in the example form: 121 121 ``` 122 122 gazette=01 123 123 lldap=02 ··· 129 129 ``` 130 130 /volume1/{sheet}/station/ 131 131 ├── prod/ # UID: N0000 132 - │ ├── service-registry # Service name to number mapping 132 + │ ├── machine-registry # Machine name to number mapping 133 133 │ ├── port-allocations # Track allocated ports (optional) 134 134 │ └── config/ # Shared sheet configuration 135 135 └── test/ # UID: N0010 136 - └── service-registry # Test environment registry 136 + └── machine-registry # Test environment registry 137 137 ``` 138 138 139 139 ### Access Permissions 140 - - The station exports are readable by all service users in the sheet 140 + - The station exports are readable by all machine users in the sheet 141 141 - Only administrators can write to the registry 142 - - Services consult the registry during deployment to determine their service number 142 + - Machines consult the registry during deployment to determine their machine number 143 143 144 144 ## Port Allocation Strategy 145 145 ··· 177 177 178 178 ### Port Allocation Table 179 179 180 - | Service | Environment | SSEP UID | Primary Port | Secondary Port | API Port | 180 + | Machine | Environment | SMEP UID | Primary Port | Secondary Port | API Port | 181 181 |---------|-------------|----------|--------------|----------------|----------| 182 182 | station | prod | 10000 | 10000 | 10001 | 10002 | 183 183 | station | test | 10010 | 10010 | 10011 | 10012 |