인스턴스 생성 및 관리
IBM Quantum Platform 서비스에 대한 접근은 사용자가 할당된 인스턴스에 의해 제어됩니다. 사용자는 여러 인스턴스에 속할 수 있습니다.
인스턴스는 양자 프로그램 실행 및 클래식 컴퓨팅 작업(예: 오류 완화 처리)을 포함한 워크로드 실행을 관리하는 가상 서버(Qiskit Runtime의 배포)입니다. 인스턴스는 클라우드 리소스 이름(CRN)으로 식별됩니다. 이 CRN은 Qiskit 프로그램에서 워크로드를 전송할 때 사용할 수 있습니다.
대시보드에서 또는 대시보드의 "인스턴스" 탭을 클릭하여 접근 가능한 인스턴스를 확인할 수 있습니다. 각 인스턴스는 CRN 식별자와 함께 나열됩니다.
사용하려는 모든 지역에서 사용하는 각 서비스 플랜(예: Open 또는 Pay-As-You-Go)마다 별도의 인스턴스가 필요합니다. 계정 관리자와 충분한 권한이 있는 사람은 인스턴스를 생성하고 할당량, 사용 한도, 양자 컴퓨터 및 사용자 권한 등의 구성을 정의할 수 있습니다.
IBM Quantum Platform 대시보드에는 접근 가능한 인스턴스가 표시됩니다. 접근 권한에 따라 인스턴스 페이지에서 전체 세부 정보를 보거나, 편집하거나, 인스턴스를 삭제할 수 있습니다.
사용 중인 인스턴스를 파악하는 것이 중요합니다. Open 플랜과 연결되지 않은 모든 인스턴스는 비용이 발생하거나 플랜에 할당된 시간을 소모하기 때문입니다.
Open 플랜 인스턴스
Open 플랜 사용자는 세계 최고의 QPU에서 무료로 양자 Circuit을 실행할 수 있습니다(28일 롤링 윈도우당 최대 10분). QPU 사용량은 플랫폼 대시보드 및 워크로드 페이지에서 추적할 수 있습니다.
Pay-As-You-Go 플랜 인스턴스
Pay-As-You-Go 플랜은 유료 플랜입니다. 이 플랜을 사용하려면 인스턴스를 생성하고 플랜에 할당해야 합니다. 이 플랜을 사용하여 QPU에 전송된 모든 워크로드에는 요금이 부과됩니다. Pay-as-you-go 인스턴스에는 총 비용 한도를 설정할 수 있습니다(선택 사항).
Flex 플랜 인스턴스
Flex 플랜은 유료 플랜입니다. 이 플랜을 사용하려면 먼저 IBM에 문의하여 가입해야 합니다. 그런 다음 인스턴스를 생성하고 플랜에 할당하세요. 이 플랜을 사용하여 QPU에 전송된 모든 워크로드는 구독 할당량에서 차감됩니다.
관리자는 계약 기간 동안 적용되는 Flex 플랜 인스턴스의 사용 한도를 설정할 수 있습니다. 인스턴스가 관리자에 의해 "제한됨"으로 표시된 경우(사용 영역에 "남은 양" 열이 표시됨), 해당 인스턴스가 할당량(관리자가 정의)을 초과하면 활성 워크로드는 계속 실행되지만(세션 포함) 대기 중인 워크로드는 더 많은 시간이 확보될 때까지 대기열에 남아 있습니다. 인스턴스가 제한되지 않고 할당량을 초과한 경우, 해당 인스턴스로 실행된 작업은 낮은 우선순위로 실행되고 더 긴 대기 시간이 발생할 가능성이 있습니다.
인스턴스가 할당량을 초과하면 해당 인스턴스의 사용량에 경고가 표시됩니다.
Premium 플랜 인스턴스
Premium 플랜은 유료 플랜입니다. 이 플랜을 사용하려면 먼저 IBM에 문의하여 가입해야 합니다. 그런 다음 인스턴스를 생성하고 플랜에 할당하세요. 이 플랜을 사용하여 QPU에 전송된 모든 워크로드는 구독 할당량에서 차감됩니다.
관리자는 플랜의 28일 롤링 사용 윈도우 기간 동안 적용되는 Premium 플랜 인스턴스의 사용 한도를 설정할 수 있습니다. 인스턴스가 관리자에 의해 "제한됨"으로 표시된 경우(사용 영역에 "남은 양" 열이 표시됨), 해당 인스턴스가 할당량(관리자가 정의)을 초과하면 활성 워크로드는 계속 실행되지만(세션 포함) 대기 중인 워크로드는 더 많은 시간이 확보될 때까지 대기열에 남아 있습니다. 인스턴스가 제한되지 않고 할당량을 초과한 경우, 해당 인스턴스로 실행된 작업은 낮은 우선순위로 실행되고 더 긴 대기 시간이 발생할 가능성이 있습니다.
인스턴스가 할당량을 초과하면 해당 인스턴스의 사용량에 경고가 표시됩니다.
코드에서 인스턴스 지정
CRN 또는 인스턴스 이름을 사용하여 사용할 인스턴스를 지정할 수 있습니다. 서비스를 초기화할 때 또는 QPU에 워크로드를 전송할 때(예: `QiskitRuntimeService.backend()) 지정할 수 있습니다. 코드에서 인스턴스를 지정하는 방법은 계정 초기화를 참조하세요.
인스턴스가 전달되면 해당 인스턴스의 Backend 및 작업만 사용 가능합니다(Qiskit Runtime v0.40.1 이상에서 허용).
서비스를 초기화할 때 인스턴스가 포함되지 않은 경우, 계정의 모든 인스턴스에 걸쳐 모든 Backend 및 작업을 사용할 수 있습니다. 이 경우 Backend가 지정되면 인스턴스 자동 선택에 설명된 대로 해당 Backend에 접근할 수 있는 인스턴스가 자동으로 찾아 사용됩니다.
다음 기능을 사용하려면 Qiskit Runtime v0.40.1 이상이 필요합니다:
- 인스턴스 이름을 사용하여 인스턴스 지정
- 인스턴스를 전달하지 않음
- 선호하는 인스턴스 유형 및 지역 설정
Qiskit Runtime v0.42 이상의 경우, 자동 인스턴스 선택이 사용될 때 기본적으로 무료 플랜이 우선시됩니다.
인스턴스 생성
다음 단계에 따라 인스턴스를 생성하고 계정에 추가하세요. 조직을 위해 Cloud에서 Qiskit Runtime을 설정해야 하는 관리자라면 조직을 위한 Qiskit Runtime 계획을 참조하세요.
-
계정에 인스턴스를 추가하려면 먼저 헤더의 계정 전환기에서 올바른 계정과 지역이 선택되어 있는지 확인하세요.
- 여러 IBM Cloud 계정을 보유하거나 그 일원이 될 수 있습니다. 예상하는 인스턴스나 작업이 보이지 않으면 다른 계정을 사용해 보세요.
- 동일한 API 키를 사용하여 두 지역 모두에 접근할 수 있지만, 로그인한 지역에서 생성된 인스턴스만 보고 접근할 수 있습니다.
- Open 인스턴스를 생성하려면 us-east 지역을 선택해야 합니다.
지역에 대하여인스턴스는 선택한 지역에 생성됩니다. 이 지역은 다음과 같은 중요한 특성을 결정합니다:
- 사용 가능한 QPU.
- 컴파일 등의 작업 클래식 연산이 이루어지는 위치.
- 사용자의 워크플로우 데이터가 보관되는 위치.
워크플로우 데이터에는 입력 Circuit, Circuit 매개변수 및 양자 계산 결과가 포함됩니다. 샷 수, Circuit 크기 또는 기타 작업 통계와 같은 메타데이터는 포함되지 않습니다.
사용자의 워크플로우 데이터가 글로벌 분산 서비스 거부 보호 레이어에 노출되는 것을 방지하려면 가상 프라이빗 엔드포인트를 사용할 수 있습니다.
qiskit-ibm-runtime은private_endpoint매개변수를 통해 이를 지원합니다. -
대시보드 인스턴스 창에서 모두 보기를 클릭하거나, 메인 메뉴에서 인스턴스 페이지로 이동하세요.
-
인스턴스 페이지에서 인스턴스 생성을 클릭하세요.
- 이름을 입력하고 선택적으로 태그를 추가하세요.
- IBM Cloud®에서 둘 이상의 리소스 그룹에 접근할 수 있는 경우, 이 인스턴스가 속할 리소스 그룹을 변경할 수 있습니다. 자세한 내용은 리소스 그룹 관리 및 리소스 그룹의 리소스에 접근 권한 부여를 참조하세요.
-
이 인스턴스와 연결할 가격 플랜을 선택하세요(예: Pay-As-You-Go). 선택한 가격 플랜에 따라 이 인스턴스에 할당할 비용 한도 또는 시간(분) 등의 다른 옵션을 지정할 수 있습니다. 이 인스턴스가 무료 플랜과 연결되지 않은 경우, 워크로드 실행 시 비용이 발생합니다.
-
다음을 클릭하세요. 인스턴스가 접근할 수 있는 QPU 목록이 표시됩니다.
- 나열된 모든 QPU(및 향후 이 플랜에 추가되는 모든 QPU)에 인스턴스가 접근하도록 하려면 다음을 클릭하세요.
- Open 인스턴스를 설정하지 않는 경우, 이 인스턴스로 접근할 수 있는 QPU를 사용자 지정할 수 있습니다. "할당된 컴퓨팅 리소스 사용자 지정" 토글을 클릭하세요. 이 인스턴스가 접근할 특정 QPU를 선택한 후 다음을 클릭하세요.
참고
할당된 컴퓨팅 리소스를 사용자 지정하면, 상위 플랜에 변경이 있더라도 사용 가능한 QPU는 자동으로 업데이트되지 않습니다. 그러나 나중에 수동으로 QPU를 추가하거나 제거할 수 있습니다. 사용자 지정하지 않으면, 계정이 해당 플랜에서 접근 가능한 QPU에 항상 접근할 수 있습니다. 따라서 향후 플랜에 새 QPU가 추가되면 인스턴스는 자동으로 해당 QPU에 접근할 수 있습니다.
-
접근 그룹 창이 열립니다. 이 인스턴스에 대해 "협력자" 접근 그룹이 자동으로 생성됩니다. 이 접근 그룹에 추가된 사용자는 이 인스턴스에 할당된 시간을 사용할 수 있습니다. IBM Cloud 콘솔을 사용하여 추가 접근 그룹을 수정하거나 생성할 수 있습니다. 지침은 접근 그룹 설정을 참조하세요.
-
인스턴스 생성을 클릭하세요. 이제 인스턴스 페이지에서 인스턴스를 확인할 수 있습니다. 계정에 여러 플랜이 설정된 경우, 각 플랜 유형은 인스턴스 테이블에서 별도의 탭으로 표시됩니다.
인스턴스 테이블의 대기 중인 워크로드 열에는 모든 QPU에 걸쳐 해당 인스턴스에서 현재 대기 중인 워크로드 수가 표시됩니다.
인스턴스 및 할당량 편집
인스턴스 페이지에서 인스턴스를 찾으세요. 인스턴스 행 끝의 오버플로우 메뉴를 클릭하고 세부 정보 편집을 선택하세요.
관리자와 소유자만 인스턴스를 편집할 수 있습니다. 접근 권한 할당에 대한 정보는 접근 정책 및 접근 그룹 생성 가이드를 참조하세요.
보관된 인스턴스
보관된 인스턴스는 다음 시나리오 중 하나의 결과입니다.
권한이 있는 사용자가 계정을 보관한 경우
계정에 대한 충분한 권한이 있는 사용자가 인스턴스를 보관했습니다.
- 인스턴스의 대기 중인 모든 작업이 취소됩니다.
- 보관된 인스턴스는 인스턴스 페이지의 별도 "보관" 섹션에 표시됩니다.
- 작업은 여전히 검색할 수 있습니다.
- 사용자는 보관된 인스턴스에 새 작업을 제출할 수 없습니다.
- 보관된 인스턴스는 플랜의 할당량에 포함되지 않습니다.
- 충분한 권한이 있는 사용자는 자신이(또는 다른 권한 있는 사용자가) 보관한 인스턴스를 언제든지 다시 활성화할 수 있습니다.
관리하는 인스턴스를 보관하려면 인스턴스 페이지로 이동하세요. 해당 인스턴스 행의 끝에서 오른쪽에 있는 세 점 오버플로우 메뉴를 클릭한 다음 인스턴스 보관을 선택하세요.
계정이 더 이상 인스턴스 플랜에 접근할 수 없는 경우
계정이 인스턴스가 생성된 플랜에 더 이상 접근할 수 없습니다.
- 보관된 인스턴스는 인스턴스 페이지의 별도 "보관" 섹션에 표시됩니다.
- 작업은 여전히 검색할 수 있습니다.
- 사용자는 보관된 인스턴스에 새 작업을 제출할 수 없습니다.
- 보관된 인스턴스는 플랜의 할당량에 포함되지 않습니다.
- 인스턴스 플랜에 대한 가시성이 없어 보관된 인스턴스는 다시 활성화할 수 없습니다.
다음 단계
- 접근 그룹으로 작업하기.
- 사용자 관리.
- 로그인 자격 증명 저장.
- 신뢰할 수 있는 Python 환경에서 Qiskit Runtime 서비스 초기화.
- 신뢰할 수 없는 환경에서 Qiskit Runtime 서비스 초기화.