[Example] Software Migration 시나리오, Model 예시 및 활용 부분 참고 사항

[ish-hcc]

Software Migration 시나리오 참고

https://github.com/cloud-barista/cloud-migrator/blob/main/docs/02-user-scenario-for-software-migration.md

Source Group, Connection Info에 대한 정보 및 수집 API 참고

cloud-barista/cm-honeybee#50

Model

Source Software Model

https://github.com/cloud-barista/cm-model/blob/main/sw/softwaremodel.go#L141

Target Software Model

https://github.com/cloud-barista/cm-model/blob/main/sw/softwaremodel.go#L217

Source Software Model 예시

• Damselfly에 Source Software Model로 저장하기 위해 사용
• 구조

{
  "source_group_id": "db652288-047b-480b-ac86-3ef7ed57f68e",
  "connection_info_list": [
    {
      "connection_id": "1539a757-18b4-4a42-ab3f-fd4b9caaf935",
      "softwares": ...(생략)...
    },
    {
      "connection_id": "7b5ce31d-a5dc-499b-83c0-e3b816c4d024",
      "softwares": ...(생략)...
    },
    {
      "connection_id": "0b16f8ba-7dfd-4039-8b8b-b48a9a726b97",
      "softwares": ...(생략)...
    },
    {
      "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
      "softwares": ...(생략)...
    },
    {
      "connection_id": "3ba55ac0-93ad-4f0b-ac1c-50ed2a3d1226",
      "softwares": ...(생략)...
    }
  ]
}

• 실제 수집 예시
  http://210.207.104.224:8081/honeybee/source_group/db652288-047b-480b-ac86-3ef7ed57f68e/software/refined

Source Software Model 데이터 예시

  {
    "source_group_id": "db652288-047b-480b-ac86-3ef7ed57f68e",
    "connection_info_list": [
      {
        "connection_id": "1539a757-18b4-4a42-ab3f-fd4b9caaf935",
        "softwares": {
          "binaries": null,
          "packages": [
            {
              "name": "acpid",
              "type": "deb",
              "version": "1:2.0.33-1ubuntu1"
            },
            {
              "name": "apport-symptoms",
              "type": "deb",
              "version": "0.24"
            },
            {
              "name": "bash-completion",
              "type": "deb",
              "version": "1:2.11-5ubuntu1"
            }
            ...(더 많은 패키지들)...
          ],
          "containers": null,
          "kubernetes": null
        }
      },
      {
        "connection_id": "7b5ce31d-a5dc-499b-83c0-e3b816c4d024",
        "softwares": {
          "binaries": null,
          "packages": [
            {
              "name": "acpid",
              "type": "deb",
              "version": "1:2.0.33-1ubuntu1"
            },
            {
              "name": "awscli",
              "type": "deb",
              "version": "1.22.34-1"
            },
            {
              "name": "kubeadm",
              "type": "deb",
              "version": "1.32.3-1.1"
            },
            {
              "name": "kubectl",
              "type": "deb",
              "version": "1.32.3-1.1"
            },
            {
              "name": "kubelet",
              "type": "deb",
              "version": "1.32.3-1.1"
            }
            ...(더 많은 패키지들)...
          ],
          "containers": null,
          "kubernetes": null
        }
      },
      {
        "connection_id": "0b16f8ba-7dfd-4039-8b8b-b48a9a726b97",
        "softwares": {
          "binaries": null,
          "packages": [
            {
              "name": "acpid",
              "type": "deb",
              "version": "1:2.0.33-1ubuntu1"
            },
            {
              "name": "kubeadm",
              "type": "deb",
              "version": "1.32.3-1.1"
            }
            ...(더 많은 패키지들)...
          ],
          "containers": null,
          "kubernetes": null
        }
      },
      {
        "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
        "softwares": {
          "binaries": null,
          "packages": [
            {
              "name": "acpi-support",
              "type": "deb",
              "version": "0.144"
            },
            {
              "name": "aisleriot",
              "type": "deb",
              "version": "1:3.22.22-1"
            }
            ...(더 많은 패키지들)...
          ],
          "containers": [
            {
              "name": "horizon",
              "runtime": "docker",
              "container_id": "5c28560322d06bf48559078a764fec419ab0f678623cc31229d0c825cbe52c31",
              "container_image": {
                "image_name": "quay.io/openstack.kolla/horizon",
                "image_version": "2024.2-ubuntu-noble",
                "image_architecture": "x86_64",
                "image_hash": "sha256:5b3e93dc0dc20089ca7b4fb456a0e1c22352ccec15b3b402e7bea8c16ed43328"
              },
              "container_ports": null,
              "container_status": "running",
              "docker_compose_path": "",
              "mount_paths": [
                "/etc/localtime:ro",
                "/etc/timezone:ro"
              ],
              "envs": [
                {
                  "name": "KOLLA_CONFIG_STRATEGY",
                  "value": "COPY_ALWAYS"
                }
              ],
              "network_mode": "host",
              "restart_policy": "no"
            }
            ...(더 많은 컨테이너들)...
          ],
          "kubernetes": null
        }
      },
      {
        "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
        "softwares": ...(생략)...
      },
      {
        "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
        "softwares": ...(생략)...
      },
      {
        "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
        "softwares": ...(생략)...
      },
      {
        "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
        "softwares": ...(생략)...
      }
    ]
  }

Target Software Model 예시

• 위에서 Grasshopper의 /software/migration_list API로 요청시 반환되는 데이터
  https://cloud-barista.github.io/cb-tumblebug-api-web/?url=https://raw.githubusercontent.com/cloud-barista/cm-grasshopper/main/pkg/api/rest/docs/swagger.yaml#/%5BMigration%5D%20Software%20migration%20APIs/get-migration-list
• Damselfly에 Target Software Model로 저장하기 위해 사용
• Grasshopper에 Software Migration을 실제로 수행하는 API로 요청하기 위해 사용
  https://cloud-barista.github.io/cb-tumblebug-api-web/?url=https://raw.githubusercontent.com/cloud-barista/cm-grasshopper/main/pkg/api/rest/docs/swagger.yaml#/%5BMigration%5D%20Software%20migration%20APIs/migrate-software
• 구조

{
  "servers": [
    {
      "source_connection_info_id": "1539a757-18b4-4a42-ab3f-fd4b9caaf935",
      "migration_list": {
        "binaries": null,
        "packages": [
          // 다수의 패키지 정보...
        ],
        "containers": null,
        "kubernetes": null
      },
      "errors": []
    },
    {
      "source_connection_info_id": "7b5ce31d-a5dc-499b-83c0-e3b816c4d024",
      "migration_list": {
        "binaries": null,
        "packages": [
          // 다수의 패키지 정보...
        ],
        "containers": null,
        "kubernetes": null
      },
      "errors": []
    },
    {
      "source_connection_info_id": "0b16f8ba-7dfd-4039-8b8b-b48a9a726b97",
      "migration_list": {
        "binaries": null,
        "packages": [
          // 다수의 패키지 정보...
        ],
        "containers": null,
        "kubernetes": null
      },
      "errors": []
    },
    {
      "source_connection_info_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
      "migration_list": {
        "binaries": null,
        "packages": [
          // 다수의 패키지 정보...
        ],
        "containers": [
          // 다수의 컨테이너 정보...
        ],
        "kubernetes": null
      },
      "errors": []
    },
    {
      "source_connection_info_id": "3ba55ac0-93ad-4f0b-ac1c-50ed2a3d1226",
      "migration_list": {
        "binaries": null,
        "packages": [
          // 다수의 패키지 정보...
        ],
        "containers": null,
        "kubernetes": null
      },
      "errors": []
    }
  ]
}

• 실제 반환 예시 (현재 Container Type, Package Type 만 처리 가능)

Target Software Model 데이터 예시

{
  "source_group_id": "db652288-047b-480b-ac86-3ef7ed57f68e",
  "connection_info_list": [
    {
      "connection_id": "1539a757-18b4-4a42-ab3f-fd4b9caaf935",
      "softwares": {
        "binaries": null,
        "packages": [
          {
            "name": "acpid",
            "type": "deb",
            "version": "1:2.0.33-1ubuntu1"
          },
          {
            "name": "apport-symptoms",
            "type": "deb",
            "version": "0.24"
          },
          {
            "name": "bash-completion",
            "type": "deb",
            "version": "1:2.11-5ubuntu1"
          }
          // ... 총 39개 패키지
        ],
        "containers": null,
        "kubernetes": null
      }
    },
    {
      "connection_id": "7b5ce31d-a5dc-499b-83c0-e3b816c4d024",
      "softwares": {
        "binaries": null,
        "packages": [
          {
            "name": "acpid",
            "type": "deb",
            "version": "1:2.0.33-1ubuntu1"
          },
          {
            "name": "awscli",
            "type": "deb",
            "version": "1.22.34-1"
          },
          {
            "name": "helm",
            "type": "deb",
            "version": "3.18.4-1"
          },
          {
            "name": "kubeadm",
            "type": "deb",
            "version": "1.32.3-1.1"
          },
          {
            "name": "kubectl",
            "type": "deb",
            "version": "1.32.3-1.1"
          },
          {
            "name": "kubelet",
            "type": "deb",
            "version": "1.32.3-1.1"
          }
          // ... 총 57개 패키지
        ],
        "containers": null,
        "kubernetes": null
      }
    },
    {
      "connection_id": "0b16f8ba-7dfd-4039-8b8b-b48a9a726b97",
      "softwares": {
        "binaries": null,
        "packages": [
          {
            "name": "acpid",
            "type": "deb",
            "version": "1:2.0.33-1ubuntu1"
          },
          {
            "name": "kubeadm",
            "type": "deb",
            "version": "1.32.3-1.1"
          },
          {
            "name": "kubectl",
            "type": "deb",
            "version": "1.32.3-1.1"
          },
          {
            "name": "kubelet",
            "type": "deb",
            "version": "1.32.3-1.1"
          }
          // ... 총 40개 패키지
        ],
        "containers": null,
        "kubernetes": null
      }
    },
    {
      "connection_id": "f38eb436-86e0-4b22-8a35-93cbd978019e",
      "softwares": {
        "binaries": null,
        "packages": [
          {
            "name": "acpi-support",
            "type": "deb",
            "version": "0.144"
          },
          {
            "name": "aisleriot",
            "type": "deb",
            "version": "1:3.22.22-1"
          },
          {
            "name": "ansible",
            "type": "deb",
            "version": "10.7.0-1ppa~jammy"
          },
          {
            "name": "build-essential",
            "type": "deb",
            "version": "12.9ubuntu3"
          },
          {
            "name": "fluent-bit",
            "type": "deb",
            "version": "4.0.3"
          },
          {
            "name": "telegraf",
            "type": "deb",
            "version": "1.35.1-1"
          }
          // ... 총 254개 패키지 (데스크톱 환경 포함)
        ],
        "containers": [
          {
            "name": "horizon",
            "runtime": "docker",
            "container_id": "5c28560322d06bf48559078a764fec419ab0f678623cc31229d0c825cbe52c31",
            "container_image": {
              "image_name": "quay.io/openstack.kolla/horizon",
              "image_version": "2024.2-ubuntu-noble",
              "image_architecture": "x86_64",
              "image_hash": "sha256:5b3e93dc0dc20089ca7b4fb456a0e1c22352ccec15b3b402e7bea8c16ed43328"
            },
            "container_status": "running"
          }
          // ... OpenStack 관련 컨테이너들 (총 약 20개)
        ],
        "kubernetes": null
      }
    },
    {
      "connection_id": "3ba55ac0-93ad-4f0b-ac1c-50ed2a3d1226",
      "softwares": {
        "binaries": null,
        "packages": [
          {
            "name": "acpi-support",
            "type": "deb",
            "version": "0.144"
          },
          {
            "name": "build-essential",
            "type": "deb",
            "version": "12.9ubuntu3"
          },
          {
            "name": "nginx",
            "type": "deb",
            "version": "1.18.0-6ubuntu14.6"
          },
          {
            "name": "python3-paramiko",
            "type": "deb",
            "version": "2.9.3-0ubuntu1.3"
          }
          // ... 총 228개 패키지 (데스크톱 환경 포함)
        ],
        "containers": null,
        "kubernetes": null
      }
    }
  ]
}