Merge branch 'main' into feature/gui-startup-script

2026-07-29 16:58:10 +02:00
parent 0bc8f10b1a 03b00da0c6
commit c491fbd9fa
9 changed files with 247 additions and 149 deletions
@@ -1,17 +1,18 @@
 # CI/CD Runner

-## Host
+## Hosts

-TODO: Should we have a dedicated runner server?
-
-sls-vserv-bd-01-dev
+- `sls-vserv-bd-01(-dev)`
+    - Runs shellbox commands (and `ioc install ...`?)
+- `sls-vserv-bd-hla01(-dev)`
+    - Runs everything else

 ## Setup

 Resources:

- - https://docs.gitea.com/usage/actions/act-runner
- - https://linux.psi.ch/documentation/services/gitea/gitea-runner/
+- https://docs.gitea.com/usage/actions/act-runner
+- https://linux.psi.ch/documentation/services/gitea/gitea-runner/

 Register the runner: (by default the name is the machine name `sls-vserv-bd-hla01-dev.psi.ch`)
 ```
@@ -1,59 +0,0 @@
-# Manual steps to be automated
-
- [x] Define Name, e.g., TUNEFBX 
- [x] Add to Master IOC 
-    - In git repo gitea/A_BD https://gitea.psi.ch/epics_iocboot_sls/A_BD  
-    - Edit AGEBD-CPCL-MASTER_main.subs 
-    - Login on machine network and reinstall/restart master IOC 
-        - Ssh sls-lca 
-        - ioc install -V --ioc AGEBD-CPCL-MASTER –clean 
-        - ioc shell AGEBD-CPCL-MASTER then ctrl + x 
- [x] Add to Master Service 
-    - In git repo gitea/sls_bd https://gitea.psi.ch/autodeploy_bin/sls_bd 
-    - Edit AGEBD-SERVICE-MASTER.py to include 
-    - Git push 
-    - Restart master service 
- [x] Prepare python file 
-    - In git repo gitea/sls_bd https://gitea.psi.ch/autodeploy_bin/sls_bd 
-    - Copy AGEBD-SERVICE-TEMPLATE.py to AGEBD-SERVICE-TUNEFBX.py 
- [ ] Prepare IOC for new Service 
-    - [x] In git repo gitea/A_BD https://gitea.psi.ch/epics_iocboot_sls/A_BD  
-    - [x] Copy directory AGEBD-CPCL-TEMPLATE to AGEBD-CPCL-TUNEFBX 
-    - [x] Update all filenames 
-    - [x] Update all files 
-    - [ ] Add required pvs to .template file 
-    - [x] Add IOC to readme.md and find port number to be configured in yaml file 
-    - [x] Git push 
- [x] Initialize / Start IOC for new service 
-    - Login on machine network and install the new IOC 
-        - Ssh sls-lca 
-        - Cd /sls/bd/ 
-        - ioc install -V --ioc AGEBD-CPCL-TUNEFBX –clean 
-    - Login on BD IOC host for access to shellbox for initial start of new IOC 
-        - ssh sls-vserv-bd-01 
-        - sudo shellbox status   
-        - sudo shellbox reload  
-        - sudo shellbox status   
-        - sudo shellbox start "port number"  
- [x] Prepare systemd unit file 
-    - In git repo gitea/sls_bd https://gitea.psi.ch/autodeploy_bin/sls_bd 
-    - Copy systemd/AGEBD-SERVICE-TEMPLATE.service systemd/AGEBD-SERVICE-TUNEFBX.service  
-    - Edit systemd/AGEBD-SERVICE-TUNEFBX.service for starting AGEBD-SERVICE-TUNEFBX.py 
- [x] Initialize / Start systemd service 
-    - Login on BD service host 
-    - ssh sls-vserv-bd-hla01 
-    - sudo su svcusr-sls2hla 
-    - Check if systemctl is working : >>systemctl –user 
-        - If return is "Failed to connect to bus: No such file or directory" 
-        - export XDG_RUNTIME_DIR=/run/user/51393 
-    - systemctl --user daemon-reload 
-    - systemctl --user enable /sls/bd/bin/systemd/AGEBD-SERVICE-TUNEFBX.service 
-    - systemctl --user start AGEBD-SERVICE-TUNEFBX.service 
- [x] Add to Service overview GUI 
-    - In git repo gitea/sls_bd_qt https://gitea.psi.ch/autodeploy_config/sls_bd_qt  
-    - Add lines to service management gui for new service >> caqtdm_designer A_BD_ServiceManager.ui 
-    - Test updated GUI: >> caqtdm A_BD_ServiceManager.ui 
- [ ] Make GUI dedicated to new service 
-    - In git repo gitea/sls_bd_qt https://gitea.psi.ch/autodeploy_config/sls_bd_qt  
- 
- 
@@ -0,0 +1,3 @@
+# Overview
+
+Documentation for the SLS 2.0 High Level Applications Framework