인스턴스 생성 및 관리

IBM Quantum® Platform 서비스에 대한 접근은 사용자가 할당된 인스턴스에 의해 제어됩니다. 사용자는 여러 인스턴스에 속할 수 있습니다.

인스턴스는 양자 프로그램 실행 및 고전 컴퓨팅 작업(예: 오류 완화 처리)을 포함한 워크로드 실행을 관리하는 가상 서버(IBM Quantum Compute Service의 배포)입니다. 인스턴스는 클라우드 리소스 이름(CRN)으로 식별됩니다. 이 CRN은 Qiskit 프로그램에서 워크로드를 전송할 때 사용할 수 있습니다.

대시보드에서 또는 대시보드의 "인스턴스" 탭을 클릭하여 접근 가능한 인스턴스를 확인할 수 있습니다. 각 인스턴스는 CRN 식별자와 함께 나열됩니다.

사용하려는 모든 지역에서 사용하는 각 서비스 플랜(예: Open 또는 Pay-As-You-Go)마다 별도의 인스턴스가 필요합니다. 계정 관리자와 충분한 권한이 있는 사람은 인스턴스를 생성하고 할당량, 사용 한도, 양자 컴퓨터 및 사용자 권한 등의 구성을 정의할 수 있습니다.

IBM Quantum Platform 대시보드에는 접근 가능한 인스턴스가 표시됩니다. 접근 권한에 따라 인스턴스 페이지에서 전체 세부 정보를 보거나, 편집하거나, 인스턴스를 삭제할 수 있습니다.

사용 중인 인스턴스를 파악하는 것이 중요합니다. Open 플랜과 연결되지 않은 모든 인스턴스는 비용이 발생하거나 플랜에 할당된 시간을 소모하기 때문입니다.

참고

동일한 인스턴스에서 사용자가 실행한 작업과 다른 협력자가 실행한 작업은 해당 인스턴스의 보고된 사용량에 합산됩니다.

인스턴스의 사용량은 인스턴스 페이지에서 확인하거나, 적절한 권한이 있는 경우 분석 페이지에서 확인할 수 있습니다. 두 페이지에 표시되는 사용량 수치가 다를 수 있는데, 인스턴스 페이지는 현재 타임스탬프 이전의 총 사용량을 표시하는 반면, 분석 페이지는 하루 단위 경계를 사용하기 때문입니다.

Open 플랜 인스턴스

Open Plan 사용자는 세계 최고의 QPU에서 무료로 양자 Circuit을 실행할 수 있습니다(28일 롤링 윈도우당 10분의 양자 처리 장치(QPU) 사용량에 해당하는 리소스 단위(RU)). 사용량은 플랫폼 대시보드 및 워크로드 페이지에서 추적할 수 있습니다.

Pay-As-You-Go 플랜 인스턴스

Pay-As-You-Go 플랜은 유료 플랜입니다. 이 플랜을 사용하려면 인스턴스를 생성하고 플랜에 할당해야 합니다. 이 플랜을 사용하여 QPU에 전송된 모든 워크로드에는 요금이 부과됩니다. Pay-as-you-go 인스턴스에는 총 비용 한도를 설정할 수 있습니다(선택 사항).

Flex 플랜 인스턴스

Flex 플랜은 유료 플랜입니다. 이 플랜을 사용하려면 먼저 IBM에 문의하여 가입해야 합니다. 그런 다음 인스턴스를 생성하고 플랜에 할당하세요. 이 플랜을 사용하여 QPU에 전송된 모든 워크로드는 구독 할당량에서 차감됩니다.

관리자는 계약 기간 동안 적용되는 Flex 플랜 인스턴스의 사용 한도를 설정할 수 있습니다. 인스턴스가 관리자에 의해 "제한됨"으로 표시된 경우(사용 영역에 "남은 양" 열이 표시됨), 해당 인스턴스가 할당량(관리자가 정의)을 초과하면 활성 워크로드는 계속 실행되지만(세션 포함) 대기 중인 워크로드는 더 많은 시간이 확보될 때까지 대기열에 남아 있습니다. 인스턴스가 제한되지 않고 할당량을 초과한 경우, 해당 인스턴스로 실행된 작업은 낮은 우선순위로 실행되고 더 긴 대기 시간이 발생할 가능성이 있습니다.

인스턴스가 할당량을 초과하면 해당 인스턴스의 사용량에 경고가 표시됩니다.

Premium 플랜 인스턴스

Premium 플랜은 유료 플랜입니다. 이 플랜을 사용하려면 먼저 IBM에 문의하여 가입해야 합니다. 그런 다음 인스턴스를 생성하고 플랜에 할당하세요. 이 플랜을 사용하여 QPU에 전송된 모든 워크로드는 구독 할당량에서 차감됩니다.

관리자는 플랜의 28일 롤링 사용 윈도우 기간 동안 적용되는 Premium 플랜 인스턴스의 사용 한도를 설정할 수 있습니다. 인스턴스가 관리자에 의해 "제한됨"으로 표시된 경우, 사용 영역에 "남은 양" 열이 표시됩니다. 인스턴스가 "제한됨"으로 표시되고 관리자가 설정한 한도를 초과하면, 대기 중인 워크로드는 더 많은 시간이 확보될 때까지 대기열에 남아 있지만, session mode의 워크로드를 포함하여 활성 워크로드는 계속 실행됩니다.

인스턴스가 제한되지 않고 할당량을 초과한 경우, 해당 인스턴스로 실행된 워크로드는 낮은 우선순위로 실행되고 더 긴 대기 시간이 발생할 가능성이 있습니다.

인스턴스가 할당량을 초과하면 해당 인스턴스의 사용량에 경고가 표시됩니다.

코드에서 인스턴스 지정

CRN 또는 인스턴스 이름을 사용하여 사용할 인스턴스를 지정할 수 있습니다. 서비스를 초기화할 때 또는 QPU에 워크로드를 전송할 때(예: `QiskitRuntimeService.backend()) 지정할 수 있습니다. 코드에서 인스턴스를 지정하는 방법은 계정 초기화를 참조하세요.

인스턴스가 전달되면 해당 인스턴스의 Backend 및 작업만 사용 가능합니다(qiskit-ibm-runtime v0.40.1 이상에서 허용).

서비스를 초기화할 때 인스턴스가 포함되지 않은 경우, 계정의 모든 인스턴스에 걸쳐 모든 Backend 및 작업을 사용할 수 있습니다. 이 경우 Backend가 지정되면 인스턴스 자동 선택에 설명된 대로 해당 Backend에 접근할 수 있는 인스턴스가 자동으로 찾아 사용됩니다.

필수 버전

다음 기능을 사용하려면 Qiskit Runtime v0.40.1 이상이 필요합니다:

• 인스턴스 이름을 사용하여 인스턴스 지정

• 인스턴스를 전달하지 않음

• 선호하는 인스턴스 유형 및 지역 설정

Qiskit Runtime v0.42 이상의 경우, 자동 인스턴스 선택이 사용될 때 기본적으로 무료 플랜이 우선시됩니다.

인스턴스 생성

다음 단계에 따라 인스턴스를 생성하고 계정에 추가하세요. 조직을 위해 Cloud에서 Quantum Compute를 설정해야 하는 관리자라면 조직을 위한 Quantum Compute 계획을 참조하세요.

1. 계정에 인스턴스를 추가하려면 먼저 헤더의 계정 전환기에서 올바른 계정과 지역이 선택되어 있는지 확인하세요.

   • 여러 IBM Cloud 계정을 보유하거나 그 일원이 될 수 있습니다. 예상하는 인스턴스나 작업이 보이지 않으면 다른 계정을 사용해 보세요.

   • 동일한 API 키를 사용하여 두 지역 모두에 접근할 수 있지만, 로그인한 지역에서 생성된 인스턴스만 보고 접근할 수 있습니다.

   • Open 인스턴스를 생성하려면 us-east 지역을 선택해야 합니다.

   

   지역에 대하여

   인스턴스는 선택한 지역에 생성됩니다. 이 지역은 다음과 같은 중요한 특성을 결정합니다:

   • 사용 가능한 QPU.
   • 컴파일 등의 작업 고전 연산이 이루어지는 위치.
   • 사용자의 워크플로우 데이터가 보관되는 위치.

   워크플로우 데이터에는 입력 Circuit, Circuit 매개변수 및 양자 계산 결과가 포함됩니다. 샷 수, Circuit 크기 또는 기타 작업 통계와 같은 메타데이터는 포함되지 않습니다.

   사용자의 워크플로우 데이터가 글로벌 분산 서비스 거부 보호 레이어에 노출되는 것을 방지하려면 가상 프라이빗 엔드포인트를 사용할 수 있습니다. qiskit-ibm-runtime은 private_endpoint 매개변수를 통해 이를 지원합니다.

2. 대시보드 인스턴스 창에서 모두 보기를 클릭하거나, 메인 메뉴에서 인스턴스 페이지로 이동하세요.

3. 인스턴스 페이지에서 인스턴스 생성을 클릭하세요.

   • 이름을 입력하고 선택적으로 태그를 추가하세요.

   • IBM Cloud®에서 둘 이상의 리소스 그룹에 접근할 수 있는 경우, 이 인스턴스가 속할 리소스 그룹을 변경할 수 있습니다. 자세한 내용은 리소스 그룹 관리 및 리소스 그룹의 리소스에 접근 권한 부여를 참조하세요.

4. 이 인스턴스와 연결할 가격 플랜을 선택하세요(예: Pay-As-You-Go). 선택한 가격 플랜에 따라 이 인스턴스에 할당할 비용 한도 또는 RU 수 등의 다른 옵션을 지정할 수 있습니다. 이 인스턴스가 무료 플랜과 연결되지 않은 경우, 이 인스턴스로 워크로드를 실행할 때 비용이 발생합니다.

5. 다음을 클릭하세요. 인스턴스가 접근할 수 있는 QPU 목록이 표시됩니다.

   • 나열된 모든 QPU(및 향후 이 플랜에 추가되는 모든 QPU)에 인스턴스가 접근하도록 하려면 다음을 클릭하세요.

   • Open 인스턴스를 설정하지 않는 경우, 이 인스턴스로 접근할 수 있는 QPU를 사용자 지정할 수 있습니다. "할당된 컴퓨팅 리소스 사용자 지정" 토글을 클릭하세요. 이 인스턴스가 접근할 특정 QPU를 선택한 후 다음을 클릭하세요.

     참고

     할당된 컴퓨팅 리소스를 사용자 지정하면, 상위 플랜에 변경이 있더라도 사용 가능한 QPU는 자동으로 업데이트되지 않습니다. 그러나 나중에 수동으로 QPU를 추가하거나 제거할 수 있습니다. 사용자 지정하지 않으면, 계정이 해당 플랜에서 접근 가능한 QPU에 항상 접근할 수 있습니다. 따라서 향후 플랜에 새 QPU가 추가되면 인스턴스는 자동으로 해당 QPU에 접근할 수 있습니다.

     Mock 디바이스는 이 목록에서 기본적으로 숨겨져 있습니다. 토글을 켜면 표시되며, 포함할 mock 디바이스를 선택하세요. Mock 디바이스만 선택하면 인스턴스를 mock 디바이스로만 제한할 수 있습니다. 이는 학생이나 강좌 참가자에게 유용하며, 실제 QPU 시간이나 RU를 소비하지 않고 페이로드를 처음부터 끝까지 검증할 수 있습니다. 인스턴스가 mock 디바이스에만 접근할 수 있으므로, 사용자는 mock 이름으로 Backend를 선택합니다. 예: service.backend("mock_phoenix"). 자세한 내용은 Dry-run 작업을 참조하세요.

6. 접근 그룹 창이 열립니다. 이 인스턴스에 대해 "협력자" 접근 그룹이 자동으로 생성됩니다. 이 접근 그룹에 추가된 사용자는 이 인스턴스에 할당된 시간을 사용할 수 있습니다. IBM Cloud 콘솔을 사용하여 추가 접근 그룹을 수정하거나 생성할 수 있습니다. 지침은 접근 그룹 설정을 참조하세요.

7. 인스턴스 생성을 클릭하세요. 이제 인스턴스 페이지에서 인스턴스를 확인할 수 있습니다. 계정에 여러 플랜이 설정된 경우, 각 플랜 유형은 인스턴스 테이블에서 별도의 탭으로 표시됩니다.

대기 중인 워크로드

인스턴스 테이블의 대기 중인 워크로드 열에는 모든 QPU에 걸쳐 해당 인스턴스에서 현재 대기 중인 워크로드 수가 표시됩니다.

인스턴스 및 할당량 편집

인스턴스 페이지에서 인스턴스를 찾으세요. 인스턴스 행 끝의 오버플로우 메뉴를 클릭하고 세부 정보 편집을 선택하세요.

참고

관리자와 소유자만 인스턴스를 편집할 수 있습니다. 접근 권한 할당에 대한 정보는 접근 정책 및 접근 그룹 생성 가이드를 참조하세요.

인스턴스에서 Qiskit Functions 액세스 구성

참고

Functions 탭과 그 옵션은 계정에 Qiskit Functions 액세스가 구성되어 있는 경우에만 표시됩니다. 계정에 Qiskit Functions 액세스 권한이 있지만 인스턴스별로 함수 액세스를 편집하는 옵션이 보이지 않는다면, 계정이 아직 이 방식으로 마이그레이션되지 않은 것입니다. 마이그레이션하려면 담당 엔게이지먼트 매니저 또는 지원 팀에 문의하세요.

Resource Controller API를 사용하거나(인스턴스에서 Qiskit Functions 액세스 구성 참조), IBM Quantum Platform에서 다음 단계를 따라 인스턴스가 액세스할 수 있는 Qiskit Functions를 구성할 수 있습니다.

1. 인스턴스 페이지로 이동하세요.

2. 헤더의 계정 전환기에서 올바른 계정이 선택되어 있는지 확인하세요.

3. 함수 액세스를 활성화하려는 인스턴스를 찾으세요.

4. 인스턴스 행 끝의 오버플로 메뉴를 클릭한 다음 세부 정보 편집을 선택하세요.

5. Functions 탭을 클릭하세요.

6. 함수 액세스를 활성화하고 활성화하려는 함수를 선택하세요.

7. 약관을 읽고 읽었음을 확인하세요.

8. 저장을 클릭하여 변경 사항을 저장하세요.

계정에 Qiskit Functions 액세스 권한이 있다면 새 인스턴스를 추가할 때도 액세스를 구성할 수 있습니다. 인스턴스 만들기를 클릭하고 열리는 창의 단계를 따르세요. Functions 단계에서 Catalog Functions와 Custom Functions에 대한 액세스를 켜고, 인스턴스가 액세스할 수 있는 Qiskit Functions를 지정할 수 있습니다.

기본 권한과 사용자 지정 권한

IBM Quantum Platform에서 인스턴스에 대한 Qiskit Functions 액세스를 설정하면 기본 사용자 수준 권한이 적용됩니다. 기본 권한을 가진 사용자는 다음을 할 수 있습니다.

• 함수와 그 세부 정보 보기

• 함수를 사용하여 작업 제출

• 사용자 작업 공간에 저장된 파일 나열 및 다운로드

• 사용자 작업 공간의 입력 및 결과 파일 업로드, 업데이트, 삭제

사용자 지정 권한을 할당하려면 대신 Resource Controller API를 사용하세요. 자세한 내용은 인스턴스에서 Qiskit Functions 액세스 구성을 참조하세요. API 참조를 찾으려면 Functions 탭에서 함수 권한 옆의 정보 아이콘을 클릭한 다음 툴팁의 API 참조 보기 링크를 클릭하세요.

사용자 지정 권한이 있는 인스턴스의 기본 권한을 복원하려면 Resource Controller를 사용하거나, 인스턴스 페이지에서 다음과 같이 IBM Quantum Platform의 함수를 제거한 후 다시 할당하세요.

1. 인스턴스 행 끝의 오버플로 메뉴를 클릭한 다음 세부 정보 편집을 선택하세요.

2. Functions 탭을 클릭하세요.

3. 사용자 지정 권한이 있는 함수에 대한 액세스를 제거하세요.

4. 저장을 클릭하세요.

5. 단계를 반복하여 함수 액세스를 다시 할당하세요. 인스턴스의 세부 정보 편집을 선택하고, Functions 탭을 클릭하고, 함수를 선택한 다음 저장을 클릭하세요. 이제 인스턴스는 해당 함수에 대해 기본 사용자 수준 권한을 갖습니다.

보관된 인스턴스

보관된 인스턴스는 다음 시나리오 중 하나의 결과입니다.

권한이 있는 사용자가 계정을 보관한 경우

계정에 대한 충분한 권한이 있는 사용자가 인스턴스를 보관했습니다.

• 인스턴스의 대기 중인 모든 작업이 취소됩니다.
• 보관된 인스턴스는 인스턴스 페이지의 별도 "보관" 섹션에 표시됩니다.
• 작업은 여전히 검색할 수 있습니다.
• 사용자는 보관된 인스턴스에 새 작업을 제출할 수 없습니다.
• 보관된 인스턴스는 플랜의 할당량에 포함되지 않습니다.
• 충분한 권한이 있는 사용자는 자신이(또는 다른 권한 있는 사용자가) 보관한 인스턴스를 언제든지 다시 활성화할 수 있습니다.

관리하는 인스턴스를 보관하려면 인스턴스 페이지로 이동하세요. 해당 인스턴스 행의 끝에서 오른쪽에 있는 세 점 오버플로우 메뉴를 클릭한 다음 인스턴스 보관을 선택하세요.

계정이 더 이상 인스턴스 플랜에 접근할 수 없는 경우

계정이 인스턴스가 생성된 플랜에 더 이상 접근할 수 없습니다.

• 보관된 인스턴스는 인스턴스 페이지의 별도 "보관" 섹션에 표시됩니다.

• 작업은 여전히 검색할 수 있습니다.

• 사용자는 보관된 인스턴스에 새 작업을 제출할 수 없습니다.

• 보관된 인스턴스는 플랜의 할당량에 포함되지 않습니다.

• 인스턴스 플랜에 대한 가시성이 없어 보관된 인스턴스는 다시 활성화할 수 없습니다.

다음 단계

권장 사항

• 접근 그룹으로 작업하기.
• 사용자 관리.
• 로그인 자격 증명 저장.
• 신뢰할 수 있는 Python 환경에서 IBM Quantum Compute Service 초기화.
• 신뢰할 수 없는 환경에서 IBM Quantum Compute Service 초기화.