에이전트 갱신

현재 선택된 Schematics 리전의 에이전트 구성을 업데이트하여 클라우드 인프라에서 직접 작동하도록 하세요. 에이전트를 업데이트해도 에이전트의 유효성을 검증하거나 배치하지 않습니다. 업데이트할 에이전트 버전을 선택하십시오. 활동 로그를 분석하고 업데이트를 복구할 수 있습니다.

다음은 상담원 업그레이드를 사용해야 하는 시나리오입니다.

  • 문제, 기능 또는 취약한 이미지를 Schematics로 통합하려면. 예를 들어, 1.0.0 에이전트 버전을 사용 중입니다. Schematics가 v1.0.x 를 릴리스하는 경우 상담원 업데이트를 사용하여 v1.0.0- v1.1.1 를 업그레이드할 수 있습니다.
  • name, description, tags, resource group, versionagent_metadata 속성과 같은 에이전트 메타데이터를 업데이트합니다.
  • agent update 를 사용하여 업데이트된 버전을 기존 버전으로 취소할 수 있습니다.

배포된 상담원이 있는 워크스페이스의 terraform init, terraform planterraform apply 을 통해 배포된 상담원에서는 상담원 업데이트를 수행할 수 없습니다.

시작하기 전에

업데이트할 상담원 버전을 검토하고 선택합니다.

ca-mon 클러스터에서 에이전트를 업그레이드할 때는 privatepublic 서비스 엔드포인트가 모두 사용 설정되어 있는지 확인하세요. 이러한 엔드포인트는 설치 또는 업그레이드 중에만 필요합니다. 설치 또는 업그레이드가 성공적으로 완료되면 public 서비스 엔드포인트를 비활성화할 수 있습니다. 하지만 향후 에이전트 업그레이드를 위해서는 public 서비스 엔드포인트를 다시 사용 설정해야 합니다.

에이전트 정의 업데이트

원하는 클러스터와 IBM Cloud Object Storage 을 선택하여 에이전트 구성을 업데이트하십시오.

  1. IBM Cloud 콘솔에 로그인합니다.
  2. 메뉴 아이콘 햄버거 아이콘 > 플랫폼 자동화 > Schematics > 확장 기능을 클릭합니다.
    • 에이전트 선택:
      • 조치 > 에이전트 편집 을 선택하십시오.
      • 요구사항에 따라 설명, 클러스터, COS 인스턴스 이름, COS 버킷 이름, COS 버킷 지역또는 에이전트 버전 을 편집할 수 있습니다.
  3. 업데이트 및 유효성 검증 을 클릭하여 클러스터 및 IBM Cloud Object Storage 구성의 유효성을 검증하십시오.
  4. 배치 를 클릭하여 에이전트를 재배치하십시오.

CLI를 통해 상담원 정의 만들기

에이전트를 업데이트하고 관리할 IBM Cloud 지역을 선택하십시오. ibmcloud target -r <region> 를 실행하여 CLI 지역 명령 를 설정하십시오. agent create 명령에 지정된 location 와 동일한 리젼을 선택하십시오. IBM Cloud Object Storage 버킷 위치는 도시 이름이 아닌 eu-gb 또는 us-south 양식이어야 합니다. 자세한 내용은 상담원 업데이트 명령을 참조하세요.

ibmcloud schematics agent update --id AGENT_ID --location <us-south> --agent-location <us-south> --version <1.0.0> --infra-type <ibm_kubernetes> --cluster-id <cg3fgvad0dak571xxx> --cluster-resource-group <Default> --cos-instance-name <agent-cos-instance> --cos-bucket <agent-cos-bucket> --cos-location <us-east> --resource-group <Default>

에이전트 업데이트 확인

ibmcloud schematics agent get --id agent-ga-prod-cli-jan-10.soA.cd1c

API를 통해 상담원 업데이트하기

단계 에 따라 IAM 액세스 토큰을 업데이트하고 API를 통해 Schematics 로 인증하십시오. 자세한 정보는 에이전트 업데이트 를 참조하십시오.

IAM 토큰의 유효 기간이 만료된 경우, refresh_token 를 사용하여 새로운 IAM 액세스 토큰을 얻을 수 있습니다.

  curl -X PUT https://schematics.cloud.ibm.com/v2/agents/{agent_id} \-H 'Authorization: Bearer <Auth Key>' -H 'X-Feature-Agents: true' -H 'refresh_token: <refresh_token> ' -d '{
  "name": "AgentName",
  "description": "New Description",
  "resource_group": "Default",
  "tags": [
  "tag1",
  "tag2"
  ],
  "version": "v1.0.0",
  "schematics_location": "us-south",
  "agent_location": "us-south",
  "agent_infrastructure": {
  "infra_type": "ibm_kubernetes",
  "cluster_id": "cluster_id",
  "cluster_resource_group": "Default",
  "cos_instance_name": "blueprint_basic",
  "cos_bucket_name": "sample_bucket_name",
  "cos_bucket_region": "us-east"
  },
  "agent_inputs": [
  {
  "name": "ibmcloud_api_key",
  "value": "<api_key of the account where cluster and cos are present>",
  "metadata": {
  "secure": true
  }
  },
  {
  "name": "ansible_pull_ibmcloud_api_key",
  "value": "jenkins api_key for pulling agents images",
  "metadata": {
  "secure": true
  }
  },
  {
  "name": "devops_api_key",
  "value": "api_key where you want to create agent and run fvts",
  "metadata": {
  "secure": true
  }
  }
  ],
  "user_state": {
  "state": "enable"
  }
  }'

출력에 표시된 대로 에이전트 정의가 작성되었는지 확인하십시오. 후속 명령에서 사용할 에이전트 ID를 기록하십시오. 예를 들어, agentb1-gsmforvpc.soA.115c입니다.

이제 agent ID 에서 agent deploy API를 실행하여 에이전트를 배치하는 Schematics 작업공간을 업데이트하십시오. agent deploy 조작은 agent validateagent deploy 조작을 모두 시작하여 에이전트를 설정합니다.

구문

  PUT /v2/agents/<enter your agentID>/deploy HTTP/1.1
  Host: schematics.cloud.ibm.com
  Content-Type: application/json
  Authorization: Bearer

상담원 버전 기록

Schematics 에이전트의 각 버전에 대한 변경 사항 요약을 확인하세요. Schematics 에이전트를 최신 상태로 유지하여 사용 가능한 모든 기능을 활용할 수 있도록 하십시오.

Schematics 상담원 버전 기록
버전 릴리스 날짜 변경사항
1.8.0 2026년 7월 24일 Schematics v1.8.0 에이전트 버전은 1.13 및 버전의 Terraform을 지원합니다. 1.14
1.7.0 2026년 3월 5일 Schematics v1.7.0 버전의 에이전트에서는 VPE(Virtual Private Endpoints) 방식의 배포에 대한 지원이 추가되었습니다.
1.6.0 2025년 12월 15일 Schematics 에이전트 버전 v1.6.0 의 플랫폼 호환성 조정(리플래트포밍), 보안 수정, 로그 수집 문제 수정 및 다중 인증 정보 지원.
1.5.0 2025년 7월 31일 Schematics 에이전트 버전 v1.5.0 은 이제 ca-mon 지역에서 지원되며 Terraform 버전 1.10, 1.11, 1.12 을 지원합니다.
1.4.0 2025년 4월 25일 Schematics 에이전트 버전 v1.4.0 은 이제 ca-tor 지역에서 지원됩니다.
1.3.1 2025년 2월 28일 Schematics v1.3.1 에이전트 버전은 Windows 시스템 자격 증명에 대한 UI에서 ‘ ’ 인벤토리 생성 문제를 수정합니다. Ansible
1.3.0 2024년 10월 30일 Schematics 에이전트 버전 v1.3.0 은 기존의 schematics-ansible-job 대신 schematics-agent-ansible-job 을 지원하며, Terraform 버전 1.9 을 지원합니다.
1.2.0 2024년 9월 23일 Schematics v1.2.0 에이전트 버전은 Terraform 및 을 지원합니다. version 1.5 version 1.6
1.1.1 2024년 7월 23일 Schematics v1.1.1 에이전트 버전에서는 에이전트 삭제 시간 초과 기간이 연장되었으며, 에이전트 배포 관련 문제가 수정되었습니다.
1.1.0 2024년 3월 19일 Schematics 에이전트 버전 v1.1.0 에서 Red Hat OpenShift Kubernetes Service 에 있는 Schematics 에이전트에 대한 지원이 추가되었습니다.
1.0.0 2024년 1월 10일 Schematics 에이전트 버전 v1.0.0 의 에이전트 지원 기능이 정식 출시(GA)되었으며, 본격적인 운영 환경 지원이 제공됩니다.

다음 단계