gala-ragdoll Usage Guide
Installation
Manual Installation
Installing using the repo source mounted by Yum.
Configure the Yum sources openEuler22.03 and openEuler22.03:Epol in the /etc/yum.repos.d/openEuler.repo file.
[everything] # openEuler 22.03 officially released repository name=openEuler22.03 baseurl=https://repo.openeuler.org/openEuler-22.03-LTS/everything/$basearch/ enabled=1 gpgcheck=1 gpgkey=https://repo.openeuler.org/openEuler-22.03-LTS/everything/$basearch/RPM-GPG-KEY-openEuler [Epol] # openEuler 22.03:Epol officially released repository name=Epol baseurl=https://repo.openeuler.org/openEuler-22.03/EPOL/main/$basearch/ enabled=1 gpgcheck=1 gpgkey=https://repo.openeuler.org/openEuler-22.03/OS/$basearch/RPM-GPG-KEY-openEulerRun the following commands to download and install gala-ragdoll and its dependencies.
yum install gala-ragdoll # A-Ops configuration source tracing service yum install python3-gala-ragdoll yum install gala-spider # A-Ops architecture awareness service yum install python3-gala-spiderInstalling using the RPM packages. Download gala-ragdoll-vx.x.x-x.oe1.aarch64.rpm, and then run the following commands to install the modules. (
x.x-xindicates the version. Replace it with the actual version number.)rpm -ivh gala-ragdoll-vx.x.x-x.oe1.aarch64.rpm
Installing Using the A-Ops Deployment Service
Editing the Task List
Modify the deployment task list and enable the steps for gala_ragdoll:
---
step_list:
...
gala_ragdoll:
enable: false
continue: false
...
Editing the Host List
For details about the host configuration, see section 2.2.3.10 in the Deployment Management Manual.
Editing the Variable List
For details about the variable configuration, see section 2.2.3.10 in the Deployment Management Manual.
Executing the Deployment Task
See section 3 in the Deployment Management Manual to execute the deployment task.
Configuration File Description
/etc/yum.repos.d/openEuler.repo is the configuration file used to specify the Yum source address. The content of the configuration file is as follows:
[OS]
name=OS
baseurl=http://repo.openeuler.org/openEuler-22.03-LTS/OS/$basearch/
enabled=1
gpgcheck=1
gpgkey=http://repo.openeuler.org/openEuler-22.03-LTS/OS/$basearch/RPM-GPG-KEY-openEuler
YANG Model Description
/etc/yum.repos.d/openEuler.repo is expressed using the YANG language. For details, see gala-ragdoll/yang_modules/openEuler-logos-openEuler.repo.yang.
The following extended fields are added:
| Extended Field Name | Extended Field Format | Example |
|---|---|---|
| path | OS_TYPE:CONFIGURATION_FILE_PATH | openEuler:/etc/yum.repos.d/openEuler.repo |
| type | Configuration file type | ini, key-value, json, text, and more |
| spacer | Spacer between a configuration item and its value | " ", "=", ":", and more |
Attachment: Learning the YANG language: https://datatracker.ietf.org/doc/html/rfc7950/.
Creating Domains using Configuration Source Tracing
Viewing the configuration file.
gala-ragdoll contains the configuration file of the configuration source tracing.
[root@openeuler-development-1-1drnd ~]# cat /etc/ragdoll/gala-ragdoll.conf
[git] // Defines the current Git information, including the directory and user information of the Git repository.
git_dir = "/home/confTraceTestConf"
user_name = "user"
user_email = "email"
[collect] // The collect interface provided by A-Ops.
collect_address = "http://192.168.0.0:11111"
collect_api = "/manage/config/collect"
[ragdoll]
port = 11114
Creating the Configuration Domain
Adding Managed Nodes to the Configuration Domain
Adding Configurations to the Configuration Domain
Querying the Expected Configuration
Deleting Configurations
Querying the Actual Configuration
Verifying the Configuration
Configuration Synchronization
Not provided currently.
