OS 인벤토리 데이터 보기

지원되는 운영체제

OS 인벤토리 관리를 지원하는 운영체제 및 버전의 전체 목록은 운영체제 세부정보를 참조하세요.

필수 역할 및 권한

인벤토리 데이터를 나열하고 설명하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 OS 인벤토리 뷰어(roles/osconfig.inventoryViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

VM 설정

OS 인벤토리 관리를 사용하려면 이 기능을 사용하도록 VM을 구성해야 합니다. OS 인벤토리 관리를 사용하도록 VM을 구성하려면 VM Manager를 설정합니다.

VM에서 VM Manager를 설정한 후 OS 인벤토리 데이터 및 취약점 보고서를 볼 수 있습니다.

OS 인벤토리 데이터 보기

VM에 대한 OS 인벤토리 데이터 보기

Google Cloud 콘솔, gcloud CLI 또는 OS Config API를 사용하여 특정 VM의 OS 정보를 볼 수 있습니다.

콘솔

Google Cloud 콘솔을 사용하여 VM에 설치된 패키지에 대한 OS 취약점 및 정보를 보려면 다음 단계를 수행합니다.

  1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스로 이동

  2. OS 정보를 확인하려는 인스턴스의 이름을 클릭합니다. 인스턴스 세부정보 페이지가 나타납니다.
  3. OS 정보 탭을 클릭합니다.
    OS 인벤토리 데이터를 보려면 VM Manager를 사용 설정해야 합니다. Google Cloud 콘솔에 VM Manager를 사용 설정하라는 메시지가 표시되면 다음 옵션 중 하나를 선택합니다.
    • 현재 프로젝트에 사용 설정: 선택한 프로젝트의 모든 VM에 VM Manager를 사용 설정합니다.
    • 이 VM에 사용 설정: 선택한 VM에만 VM Manager를 사용 설정합니다.
  4. OS 정보 탭에서 OS 취약점 및 설치된 패키지 목록을 검토합니다.
  5. 선택사항: 설치된 패키지에 사용 가능한 업데이트가 있는 경우 패키지 이름을 선택하고 업데이트 적용을 클릭합니다.
    패치 페이지가 표시됩니다. VM Manager에서 패치 기능을 사용하는 방법에 대한 자세한 내용은 패치 작업 만들기를 참조하세요.

gcloud

특정 VM의 인벤토리 세부정보를 보려면 os-config inventories describe 명령어를 실행합니다.

gcloud compute os-config inventories describe VM_NAME \
    --location=ZONE \
    --view=VIEW

다음을 바꿉니다.

  • VM_NAME: VM의 이름
  • ZONE: VM 인스턴스가 있는 영역
  • VIEW: 필요한 출력 정보 유형입니다. 사용 가능한 뷰 유형은 다음과 같습니다.

    • basic: OS 정보만 표시
    • full: OS 및 패키지 정보 표시

      지정하지 않는 경우 기본값은 basic입니다.

    예시(기본 뷰)

    gcloud compute os-config inventories describe vm1-centos \
       --location=us-central1-c
    

    출력 예시

    architecture: x86_64
    hostname: vm1-centos
    kernelRelease: 3.10.0-1160.92.1.el7.x86_64
    kernelVersion: '#1 SMP Tue Jun 20 11:48:01 UTC 2023'
    longName: CentOS Linux 7 (Core)
    osconfigAgentVersion: 20230504.00-g1.el7
    shortName: centos
    updateTime: '2023-07-26T17:03:50Z'
    version: '7'
    

    예시(전체 보기)

    gcloud compute os-config inventories describe vm1-centos \
       --location=us-central1-c \
       --view=full
    

    Linux 예시 출력

    ┌─────────────────────────────────────────────────────────────────────────────────────┐
    │                               Installed Packages (Yum)                              │
    ├─────────────────────────────────────┬──────────────┬────────────────────────────────┤
    │             PACKAGE_NAME            │ ARCHITECTURE │            VERSION             │
    ├─────────────────────────────────────┼──────────────┼────────────────────────────────┤
    │ GeoIP                               │ x86_64       │ 1.5.0-13.el7                   │
    │ NetworkManager                      │ x86_64       │ 1:1.12.0-8.el7_6               │
    │ NetworkManager-libnm                │ x86_64       │ 1:1.12.0-8.el7_6               │
    │ NetworkManager-team                 │ x86_64       │ 1:1.12.0-8.el7_6               │
    │ NetworkManager-tui                  │ x86_64       │ 1:1.12.0-8.el7_6               │
    │ acl                                 │ x86_64       │ 2.2.51-14.el7                  │
    │ yum-cron                            │ all          │ 3.4.3-161.el7.centos           │
    │ yum-metadata-parser                 │ x86_64       │ 1.1.4-10.el7                   │
    │ yum-plugin-fastestmirror            │ all          │ 1.1.31-50.el7                  │
    │ zlib                                │ x86_64       │ 1.2.7-18.el7                   │
    └─────────────────────────────────────┴──────────────┴────────────────────────────────┘
    ┌───────────────────────────────────────────────────────────────────────────────┐
    │                        Package Updates Available (Yum)                        │
    ├───────────────────────────────┬──────────────┬────────────────────────────────┤
    │          PACKAGE_NAME         │ ARCHITECTURE │            VERSION             │
    ├───────────────────────────────┼──────────────┼────────────────────────────────┤
    │ GeoIP                         │ x86_64       │ 1.5.0-14.el7                   │
    │ NetworkManager                │ x86_64       │ 1:1.18.8-2.el7_9               │
    │ NetworkManager-libnm          │ x86_64       │ 1:1.18.8-2.el7_9               │
    │ NetworkManager-team           │ x86_64       │ 1:1.18.8-2.el7_9               │
    │ yum-cron                      │ all          │ 3.4.3-168.el7.centos           │
    │ yum-plugin-fastestmirror      │ all          │ 1.1.31-54.el7_8                │
    │ zlib                          │ x86_64       │ 1.2.7-19.el7_9                 │
    └───────────────────────────────┴──────────────┴────────────────────────────────┘
    architecture: x86_64
    hostname: vm1-centos
    kernelRelease: 3.10.0-957.1.3.el7.x86_64
    kernelVersion: '#1 SMP Thu Nov 29 14:49:43 UTC 2018'
    longName: CentOS Linux 7 (Core)
    osconfigAgentVersion: 20230504.00-g1.el7
    shortName: centos
    updateTime: '2021-05-11T22:21:52.323Z'
    version: '7'
    

    Windows 예시 출력

    ┌───────────────────────────────────────────────────────────┐
    │                Installed Packages (GooGet)                │
    ├───────────────────────┬──────────────┬────────────────────┤
    │      PACKAGE_NAME     │ ARCHITECTURE │      VERSION       │
    ├───────────────────────┼──────────────┼────────────────────┤
    │ google-osconfig-agent │ x86_64       │ 20210415.4.0+win@1 │
    └───────────────────────┴──────────────┴────────────────────┘
    ┌───────────────────────────────────────────────────┐
    │     Installed Packages (Windows Update Agent)     │
    ├───────┬────────────┬────────────────┬─────────────┤
    │ TITLE │ CATEGORIES │ KB_ARTICLE_IDS │ SUPPORT_URL │
    ├───────┼────────────┼────────────────┼─────────────┤
    │ title │ C1, C2     │ 4589208        │ url.com     │
    └───────┴────────────┴────────────────┴─────────────┘
    ┌───────────────────────────────────────────────────────────────┐
    │           Installed Packages (Quick Fix Engineering)          │
    ├─────────┬─────────────────┬────────────┬──────────────────────┤
    │ CAPTION │   DESCRIPTION   │ HOT_FIX_ID │     INSTALL_TIME     │
    ├─────────┼─────────────────┼────────────┼──────────────────────┤
    │ caption │ Security Update │ KB4470788  │ 2019-03-12T00:00:00Z │
    └─────────┴─────────────────┴────────────┴──────────────────────┘
    ┌───────────────────────────────────────────────────────────────────────────┐
    │                  Installed Packages (Windows Application)                 │
    ├──────────────────┬─────────────────┬───────────────────────┬──────────────┤
    │   DISPLAY_NAME   │ DISPLAY_VERSION │       PUBLISHER       │ INSTALL_DATE │
    ├──────────────────┼─────────────────┼───────────────────────┼──────────────┤
    │ PowerShell 7-x64 │ 7.0.2.0         │ Microsoft Corporation │ 2021-06-08   │
    └──────────────────┴─────────────────┴───────────────────────┴──────────────┘
    ┌───────────────────────────────────────────────────────────┐
    │             Package Updates Available (GooGet)            │
    ├───────────────────────┬──────────────┬────────────────────┤
    │      PACKAGE_NAME     │ ARCHITECTURE │      VERSION       │
    ├───────────────────────┼──────────────┼────────────────────┤
    │ google-osconfig-agent │ x86_64       │ 20210415.4.0+win@1 │
    └───────────────────────┴──────────────┴────────────────────┘
    ┌───────────────────────────────────────────────────┐
    │  Package Updates Available (Windows Update Agent) │
    ├───────┬────────────┬────────────────┬─────────────┤
    │ TITLE │ CATEGORIES │ KB_ARTICLE_IDS │ SUPPORT_URL │
    ├───────┼────────────┼────────────────┼─────────────┤
    │ title │ C1, C2     │ 4589208        │ url.com     │
    └───────┴────────────┴────────────────┴─────────────┘
    ┌───────────────────────────────────────────────────────────────┐
    │       Package Updates Available (Quick Fix Engineering)       │
    ├─────────┬─────────────────┬────────────┬──────────────────────┤
    │ CAPTION │   DESCRIPTION   │ HOT_FIX_ID │     INSTALL_TIME     │
    ├─────────┼─────────────────┼────────────┼──────────────────────┤
    │ caption │ Security Update │ KB4470788  │ 2019-03-12T00:00:00Z │
    └─────────┴─────────────────┴────────────┴──────────────────────┘
    architecture: x86_64
    hostname: vm3-windows
    kernelRelease: 10.0.17763.1817
    kernelVersion: 10.0.17763.1817 (WinBuild.160101.0800)
    longName: Microsoft Windows Server 2019 Datacenter
    osconfigAgentVersion: 20210901.00.0+win@1
    shortName: windows
    updateTime: '2021-09-12T22:14:35Z'
    version: 10.0.17763
    

REST

특정 VM의 인벤토리 세부정보를 보려면 projects.locations.instances.inventories.get 메서드에 대해 GET 요청을 만듭니다.

   GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE/inventory
   

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID
  • ZONE: VM 인스턴스가 있는 영역
  • INSTANCE: 인스턴스 ID 또는 VM의 이름 지정

특정 영역에 있는 VM에 대한 OS 인벤토리 데이터 보기

gcloud CLI 또는 OS Config API를 사용하여 특정 영역에 있는 VM에 대한 OS 정보를 볼 수 있습니다.

gcloud

특정 영역에서 VM에 대한 인벤토리 데이터 목록을 보려면 os-config inventories list 명령어를 실행합니다.

gcloud compute os-config inventories list \
    --location=ZONE \
    --view=VIEW

다음을 바꿉니다.

  • ZONE: VM이 있는 영역
  • VIEW: 필요한 출력 정보 유형입니다. 사용 가능한 뷰 유형은 다음과 같습니다.

    • basic: OS 정보만 표시
    • full: OS 및 패키지 정보 표시

      지정하지 않는 경우 기본값은 basic입니다.

    예시(기본 뷰)

    gcloud compute os-config inventories list \
       --location=us-central1-c
    

    출력은 다음과 비슷합니다.

    INSTANCE_ID          INSTANCE_NAME     OS                                         OSCONFIG_AGENT_VERSION       UPDATE_TIME
    29255009728795105    vm1-centos        CentOS Linux 7 (Core)                      20230504.00-g1.el7           2023-07-26T16:53:49Z
    5138980234596718741  vm2-rhel8         Red Hat Enterprise Linux 8.8 (Ootpa)       20230504.00-g1.el8           2023-07-26T16:55:33Z
    7127836223366142250  vm3-windows       Microsoft Windows Server 2022 Datacenter   20230403.00.0+win@1          2023-07-26T16:49:16Z
    

    예시(전체 보기)

    gcloud compute os-config inventories list \
       --location=us-central1-c \
       --view=full
    

    출력은 다음과 비슷합니다.

    INSTANCE_ID          INSTANCE_NAME     OS                                       INSTALLED_PACKAGES   AVAILABLE_PACKAGES  OSCONFIG_AGENT_VERSION       UPDATE_TIME
    29255009728795105    vm1-centos        CentOS Linux 7 (Core)                    334                    2                 20230504.00-g1.el7           2023-07-26T16:53:49Z
    5932621394110773366  vm2-rhel8         Red Hat Enterprise Linux 8.8 (Ootpa)     410                  138                 20230504.00-g1.el8           2023-07-26T16:55:33Z
    7127836223366142250  vm3-windows       Microsoft Windows Server 2022 Datacenter  36                    6                 20230403.00.0+win@1          2023-07-26T16:49:16Z
    

REST

특정 영역에 있는 VM의 인벤토리 데이터 목록을 보려면 projects.locations.instances.inventories.list 메서드에 대해 GET 요청을 만듭니다.

   GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/–/inventories
   

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다.
  • ZONE: VM이 있는 영역

Cloud 애셋 인벤토리에서 OS 인벤토리 데이터 보기

OS 인벤토리 관리는 인벤토리 및 취약점 보고서 데이터를 저장하고 Cloud 애셋 인벤토리에 전달합니다. Cloud 애셋 인벤토리는 Google Cloud 간에 애셋을 확인, 모니터, 분석할 수 있게 해주는 메타데이터 인벤토리 서비스입니다. Cloud 애셋 인벤토리에서 정보를 폴링하고 데이터의 변경사항을 확인할 수 있습니다.

Cloud 애셋 인벤토리에서 OS 인벤토리 및 취약점 보고서 데이터에 액세스하려면 다음 설정을 완료해야 합니다.

자세한 내용은 VM Manager 데이터 보기를 참조하세요.

OS 인벤토리 관리(이전 버전)

이전 버전의 OS 인벤토리 관리를 계속 사용하는 경우 다음 섹션을 펼쳐 Google Cloud CLI에 대한 안내를 살펴보세요.

OS 인벤토리 관리(이전 버전)

VM 나열

OS 인벤토리 관리가 설정된 VM 목록을 보려면 instances os-inventory list-instances 명령어를 실행합니다.

예를 들어 인벤토리 데이터가 있는 모든 VM을 나열하려면 다음 명령어를 실행합니다.

gcloud compute instances os-inventory list-instances

출력은 다음과 비슷합니다.

  NAME                 ZONE          MACHINE_TYPE   PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP STATUS
  inventory-instance   us-east1-b    e2-standard-2               192.0.2.1    RUNNING
  instance-inventory1  us-west1-b    e2-standard-2               192.0.2.2    RUNNING
  instance-inventory2  asia-east2-b  e2-standard-2               192.0.2.3    RUNNING
  

필터를 사용하여 결과 범위를 좁힐 수도 있습니다. 예를 들어 다음 명령어를 실행하여 OS 인벤토리 관리가 설정되어 있고 호스트 이름이 정규 표현식 instance-*와 일치하는 모든 VM을 나열할 수 있습니다.

gcloud compute instances os-inventory list-instances
      --inventory-filter="Hostname~instance-*"

출력은 다음과 비슷합니다.

  NAME                 ZONE         MACHINE_TYPE   PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP STATUS
  inventory-instance   us-east1-b   e2-standard-2               192.0.2.1    RUNNING
  instance-inventory1  us-west1-b   e2-standard-2               192.0.2.2    RUNNING
  instance-inventory2  asia-east2-b e2-standard-2               192.0.2.3    RUNNING
  
인벤토리 데이터 보기

VM의 인벤토리 데이터를 보려면 instances os-inventory describe 명령어를 사용합니다.

VM에 대해 수집된 인벤토리 데이터를 보려면 다음 명령어를 실행합니다.

gcloud compute instances os-inventory describe VM_NAME \
      --zone=ZONE

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.
  • ZONE: VM이 있는 영역

반환되는 출력 세부정보 유형을 보려면 OS 인벤토리 관리에서 제공하는 정보를 참조하세요.

다음 단계