첫 번째 Qiskit Serverless 프로그램 작성하기

패키지 버전

이 페이지의 코드는 다음 요구 사항을 사용하여 개발되었습니다. 이 버전 이상을 사용하길 권장합니다.

qiskit[all]~=1.3.1
qiskit-ibm-runtime~=0.34.0
qiskit-aer~=0.15.1
qiskit-serverless~=0.18.1
qiskit-ibm-catalog~=0.2
qiskit-addon-sqd~=0.8.1
qiskit-addon-utils~=0.1.0
qiskit-addon-mpf~=0.2.0
qiskit-addon-aqc-tensor~=0.1.2
qiskit-addon-obp~=0.1.0
scipy~=1.15.0
pyscf~=2.8.0

이 예제는 qiskit-serverless 도구를 사용하여 병렬 트랜스파일 프로그램을 생성하고, qiskit-ibm-catalog를 구현하여 프로그램을 IBM Quantum Platform에 배포함으로써 재사용 가능한 원격 서비스로 활용하는 방법을 설명합니다.

예제: Qiskit Serverless를 이용한 원격 Transpiler

먼저 다음 예제를 살펴보겠습니다. 이 예제는 주어진 backend와 대상 optimization_level에 대해 circuit을 트랜스파일하며, 워크로드를 Qiskit Serverless에 배포하기 위한 요소들을 점진적으로 추가합니다.

다음 코드 셀을 ./source_files/transpile_remote.py 파일에 넣어 주세요. 이 파일이 Qiskit Serverless에 업로드할 프로그램입니다.

# Added by doQumentation — required packages for this notebook
!pip install -q qiskit qiskit-ibm-catalog qiskit-ibm-runtime qiskit-serverless

# This cell is hidden from users, it just creates a new folder
from pathlib import Path

Path("./source_files").mkdir(exist_ok=True)

%%writefile ./source_files/transpile_remote.py

from qiskit.transpiler import generate_preset_pass_manager

def transpile_remote(circuit, optimization_level, backend):
    """Transpiles an abstract circuit into an ISA circuit for a given backend."""
    pass_manager = generate_preset_pass_manager(
        optimization_level=optimization_level,
		backend=backend
    )
    isa_circuit = pass_manager.run(circuit)
    return isa_circuit

Writing ./source_files/transpile_remote.py

파일 설정하기

Qiskit Serverless를 사용하려면 워크로드의 .py 파일을 전용 디렉토리에 설정해야 합니다. 다음 구조는 모범 사례의 예시입니다.

serverless_program
├── program_uploader.ipynb
└── source_files
    ├── transpile_remote.py
    └── *.py

Serverless는 source_files의 내용을 업로드하여 원격으로 실행합니다. 설정이 완료되면 transpile_remote.py를 수정하여 입력을 가져오고 출력을 반환할 수 있습니다.

프로그램 인수 가져오기

초기 transpile_remote.py에는 circuits, backend_name, optimization_level 세 가지 입력이 있습니다. Serverless는 현재 직렬화 가능한 입력 및 출력만 허용하도록 제한되어 있습니다. 이러한 이유로 backend를 직접 전달할 수 없으므로, 대신 backend_name을 문자열로 사용합니다.

%%writefile --append ./source_files/transpile_remote.py

from qiskit_serverless import get_arguments, save_result, distribute_task, get

# Get program arguments
arguments = get_arguments()
circuits = arguments.get("circuits")
backend_name = arguments.get("backend_name")
optimization_level = arguments.get("optimization_level")

Appending to ./source_files/transpile_remote.py

이 시점에서 QiskitRuntimeService를 사용하여 Backend를 가져오고, 다음 코드로 기존 프로그램을 추가할 수 있습니다. 아래 코드를 실행하려면 자격 증명을 저장해 두어야 합니다.

%%writefile --append ./source_files/transpile_remote.py

from qiskit_ibm_runtime import QiskitRuntimeService

service = QiskitRuntimeService()
backend = service.backend(backend_name)

Appending to ./source_files/transpile_remote.py

마지막으로, 전달된 모든 circuits에 대해 transpile_remote()를 실행하고 transpiled_circuits를 결과로 반환할 수 있습니다.

%%writefile --append ./source_files/transpile_remote.py

results = [
    transpile_remote(circuit, 1, backend)
    for circuit in circuits
]

save_result({
    "transpiled_circuits": results
})

Appending to ./source_files/transpile_remote.py

IBM Quantum Platform에 배포하기

이전 섹션에서는 원격으로 실행할 프로그램을 생성했습니다. 이 섹션의 코드 셀은 해당 프로그램을 Qiskit Serverless에 업로드합니다.

qiskit-ibm-catalog를 사용하여 API 키로 QiskitServerless에 인증하고 프로그램을 업로드합니다. API 키는 IBM Quantum 대시보드에서 확인할 수 있습니다.

save_account()를 사용하여 자격 증명을 저장할 수 있습니다(IBM Cloud 사용 설정 섹션 참조). 이 명령은 자격 증명을 QiskitRuntimeService.save_account()와 동일한 파일에 저장한다는 점에 유의하세요.

from qiskit_ibm_catalog import QiskitServerless, QiskitFunction

# Authenticate to the remote cluster and submit the pattern for remote execution
serverless = QiskitServerless()

Qiskit Serverless는 working_dir의 내용(이 경우 source_files)을 tar로 압축하여 업로드하고, 이후 정리합니다. entrypoint는 Qiskit Serverless가 실행할 기본 프로그램 실행 파일을 식별합니다. 또한 프로그램에 사용자 정의 pip 의존성이 있는 경우 dependencies 배열에 추가할 수 있습니다.

transpile_remote_demo = QiskitFunction(
    title="transpile_remote_serverless",
    entrypoint="transpile_remote.py",
    working_dir="./source_files/",
)

serverless.upload(transpile_remote_demo)

QiskitFunction(transpile_remote_serverless)

업로드가 성공적으로 완료되었는지 확인하려면 serverless.list()를 사용합니다.

# Get program from serverless.list() that matches the title of the one we uploaded
next(
    program
    for program in serverless.list()
    if program.title == "transpile_remote_serverless"
)

QiskitFunction(transpile_remote_serverless)

# This cell is hidden from users, it checks the program uploaded correctly
assert _.title == "transpile_remote_serverless"  # noqa: F821

# This cell is hidden from users, it checks the program executes correctly
from time import sleep
from qiskit import QuantumCircuit

qc = QuantumCircuit(2)
transpile_remote_serverless = serverless.load("transpile_remote_serverless")
job = transpile_remote_serverless.run(
    circuits=[qc],
    backend="ibm_sherbrooke",
    optimization_level=1,
)
while True:
    sleep(5)
    status = job.status()
    if status not in ["QUEUED", "INITIALIZING", "RUNNING", "DONE"]:
        raise Exception(
            f"Unexpected job status: '{status}'\n"
            + "Here are the logs:\n"
            + job.logs()
        )
    if status == "DONE":
        break

다음 단계

권장 사항

• 첫 번째 Qiskit Serverless 워크로드를 원격으로 실행하기 항목에서 입력을 전달하고 프로그램을 원격으로 실행하는 방법을 알아보세요.