에이전트 갱신
현재 선택된 Schematics 리전의 에이전트 구성을 업데이트하여 클라우드 인프라에서 직접 작동하도록 하세요. 에이전트를 업데이트해도 에이전트의 유효성을 검증하거나 배치하지 않습니다. 업데이트할 에이전트 버전을 선택하십시오. 활동 로그를 분석하고 업데이트를 복구할 수 있습니다.
다음은 상담원 업그레이드를 사용해야 하는 시나리오입니다.
- 문제, 기능 또는 취약한 이미지를 Schematics로 통합하려면. 예를 들어,
1.0.0에이전트 버전을 사용 중입니다. Schematics가v1.0.x를 릴리스하는 경우 상담원 업데이트를 사용하여v1.0.0-v1.1.1를 업그레이드할 수 있습니다. name,description,tags,resource group,version및agent_metadata속성과 같은 에이전트 메타데이터를 업데이트합니다.agent update를 사용하여 업데이트된 버전을 기존 버전으로 취소할 수 있습니다.
배포된 상담원이 있는 워크스페이스의 terraform init, terraform plan 및 terraform apply 을 통해 배포된 상담원에서는 상담원 업데이트를 수행할 수 없습니다.
시작하기 전에
업데이트할 상담원 버전을 검토하고 선택합니다.
ca-mon 클러스터에서 에이전트를 업그레이드할 때는 private 및 public 서비스 엔드포인트가 모두 사용 설정되어 있는지 확인하세요. 이러한 엔드포인트는 설치 또는 업그레이드 중에만 필요합니다. 설치 또는 업그레이드가 성공적으로 완료되면 public 서비스 엔드포인트를 비활성화할 수 있습니다. 하지만 향후 에이전트 업그레이드를
위해서는 public 서비스 엔드포인트를 다시 사용 설정해야 합니다.
에이전트 정의 업데이트
원하는 클러스터와 IBM Cloud Object Storage 을 선택하여 에이전트 구성을 업데이트하십시오.
- IBM Cloud 콘솔에 로그인합니다.
- 메뉴 아이콘
> 플랫폼 자동화 > Schematics > 확장 기능을 클릭합니다.
- 에이전트 선택:
- 조치 > 에이전트 편집 을 선택하십시오.
- 요구사항에 따라 설명, 클러스터, COS 인스턴스 이름, COS 버킷 이름, COS 버킷 지역또는 에이전트 버전 을 편집할 수 있습니다.
- 에이전트 선택:
- 업데이트 및 유효성 검증 을 클릭하여 클러스터 및 IBM Cloud Object Storage 구성의 유효성을 검증하십시오.
- 배치 를 클릭하여 에이전트를 재배치하십시오.
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 validate 및 agent deploy 조작을 모두 시작하여 에이전트를 설정합니다.
구문
PUT /v2/agents/<enter your agentID>/deploy HTTP/1.1
Host: schematics.cloud.ibm.com
Content-Type: application/json
Authorization: Bearer
상담원 버전 기록
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)되었으며, 본격적인 운영 환경 지원이 제공됩니다. |