마스터 플러그인 업무 공간에서는 Salt 마스터의 마스터 플러그인 버전을 Automation Config 버전과 일치하도록 업데이트할 수 있습니다. 이 기능은 클라우드 및 온-프레미스 배포 모두에서 지원됩니다. 최신 버전의 마스터 플러그인을 다운로드할 수도 있습니다.
마스터 플러그인 업무 공간은 플러그인 상태, 플러그인 버전, Salt 버전, 마지막 업데이트 JID 등에 대한 정보를 제공합니다. 최신 버전의 sseapiclient
는 마스터 플러그인 업무 공간을 통해서도 사용할 수 있습니다. 자세한 내용은 API 사용을 참조하십시오.
마스터 플러그인 업무 공간은 플러그인 상태, 플러그인 버전, Salt 버전, 마지막 업데이트 JID 등에 대한 정보를 제공합니다. 최신 버전의 sseapiclient
는 마스터 플러그인 업무 공간을 통해서도 사용할 수 있습니다. 자세한 내용은 API 사용을 참조하십시오.
마스터 플러그인을 사용하면 Salt 마스터가 Automation Config와 통신할 수 있습니다. 플러그인에는 성능 향상을 위해 조정할 수 있는 다양한 설정도 포함되어 있습니다. 자세한 내용은 마스터 플러그인 구성 설정 참조를 참조하십시오.
RaaS에는 현재 및 이전 버전의 마스터 플러그인이 있습니다. Salt 마스터가 RaaS에 연결되면 Salt 마스터에 없는 플러그인 버전이 RaaS에 있는지 확인합니다. Salt 마스터에 해당 플러그인 버전이 없는 경우 Salt 마스터는 RaaS에서 플러그인을 검색하여 /var/cache/salt/master/plugin_cache/
에 로컬로 캐시합니다.
새 버전의 Automation Config를 사용할 수 있는 경우 플러그인은 자동으로 업데이트되지 않습니다. 업데이트 프로세스를 직접 시작해야 합니다. 사용 가능한 경우 최신 버전의 플러그인으로 업데이트하는 것이 좋습니다.
마스터 플러그인 업데이트 프로세스는 Salt의 service
모듈 및 service.running
상태에 의존하여 플러그인 업데이트 후 Salt 마스터를 다시 시작합니다. service
모듈은 배포의 init 관리자(예: systemd
)에 따라 다릅니다.
컨테이너 또는 init 관리자를 사용하지 않는 배포에서 Salt 마스터를 실행 중인 경우 업데이트 후 Salt 마스터를 수동으로 다시 시작해야 합니다. Salt 마스터를 다시 시작하지 않으면 마스터 플러그인 업무 공간은 Salt 마스터가 오래된 플러그인 버전을 실행 중이라고 보고합니다.
시작하기 전에
마스터 플러그인 업무 공간을 사용하려면 먼저 다음 사전 요구 사항을 완료해야 합니다.
- Salt 마스터에 마스터 플러그인을 설치합니다. 자세한 내용은 마스터 플러그인 설치 및 구성을 참조하십시오.
- Salt 마스터에 마스터 플러그인을 설치합니다. 자세한 내용은 마스터 플러그인 설치 및 구성을 참조하십시오.
- Salt 마스터의 키가 Automation Config 사용자 인터페이스에서 수락되었는지 확인합니다.
- Salt 마스터가
root
로 실행 중인지 확인합니다. Salt 마스터가 루트가 아닌 사용자로 실행 중이면 업데이트가 실패합니다. - Salt 마스터가 Salt 버전 3002.1 이상을 실행 중인지 확인합니다. Salt 마스터가 버전 3002 이하를 실행 중인 경우 먼저 Salt 버전을 업데이트해야 마스터 플러그인 업무 공간을 사용할 수 있습니다. 자세한 내용은 Salt 업그레이드를 참조하십시오.
- Salt 마스터가 마스터 플러그인 버전 8.11.2 이상을 실행 중인지 확인합니다. Salt 마스터가 8.11.1 이하 버전을 실행 중인 경우 먼저 플러그인을 수동으로 업그레이드해야 마스터 플러그인 업무 공간을 사용할 수 있습니다. 자세한 내용은 CLI를 사용하여 마스터 플러그인 업그레이드를 참조하십시오.
마스터 플러그인 업데이트
하나 이상의 Salt 마스터에서 마스터 플러그인 버전을 업데이트할 수 있습니다.
플러그인 상태가 업데이트 필요인 경우 마스터 플러그인 업무 공간을 통해서만 마스터 플러그인 버전을 업데이트할 수 있습니다. 플러그인 상태에 Salt 마스터에 수동 작업이 필요하다고 표시되면 Salt 마스터에 로그인하여 문제를 해결해야 합니다. 자세한 내용은 플러그인 업데이트 문제 해결 항목을 참조하십시오.
마스터 플러그인을 업데이트하려면:
- Automation Config에서 을 선택합니다.
- 플러그인 상태가 업데이트 필요인 Salt 마스터를 선택합니다.
- 업데이트를 클릭합니다.
- 대화상자의 정보를 검토하여 올바른 Salt 마스터를 선택했는지 확인합니다.
- 업데이트를 클릭합니다.
- 업데이트 진행률을 모니터링하려면 마지막 업데이트 JID를 클릭합니다.
- 마스터 플러그인 업무 공간에서 플러그인 상태가 최신으로 변경되었는지 확인합니다.
업데이트가 실패하면 플러그인 업데이트 문제 해결의 내용을 참조하십시오.
플러그인 업데이트 문제 해결
플러그인 업데이트가 실패하면 Salt 마스터에 로그인하여 수동으로 문제를 해결해야 합니다. 실패한 플러그인 업데이트에 대한 자동 되돌리기는 없습니다.
- 인프라 문제
- 가상 시스템의 구성 문제
- Salt 마스터와의 연결 문제
다음 단계를 수행하여 실패한 업데이트의 원인을 식별합니다.
- 마지막 업데이트 JID를 확인하고 원시 데이터에 오류가 있는지 검토합니다.
systemctl status salt-master
를 실행하여salt-master
서비스의 상태를 확인합니다.salt-master -l debug
를 실행하여 디버그 모드에서 Salt 마스터를 시작합니다.- 마스터 플러그인 업무 공간에서 마스터 플러그인을 다운로드하고 플러그인을 수동으로 설치합니다.