Wasmtime 50.0.0 업그레이드: 호환성과 서버 운영 점검

Wasmtime 50.0.0의 기본값과 비동기 동작 변경을 확인하고 서버 실행, HTTP 검증, 임베딩 코드의 업그레이드 점검 항목을 정리한다.

2026-11-01

업그레이드 전에 기본값 의존부터 확인한다

Wasmtime CLI에서 wasi_unstable을 사용하는 모듈은 업그레이드 후에도 기존 기본값에 기대어 실행해서는 안 된다. **Wasmtime v50.0.0 (2026-10-20)**부터 WASIp0는 기본 활성화 대상에서 빠졌고, 필요한 경우 -Spreview0로 활성화해야 한다.

Wasmtime 50.0.0 공식 릴리스노트를 운영 변경으로 읽을 때는 기능 추가와 기존 실행 조건의 변경을 구분해야 한다. 새 옵션을 도입하기 전에 현재 배포가 어떤 기본값과 동작에 의존하는지 확인하는 편이 순서에 맞다.

점검 대상을 실행 계층별로 나누면 빠뜨릴 범위가 드러난다. CLI 실행 환경은 WASIp0와 Winch 기본값을, 비동기 컴포넌트는 취소와 핸들 수명을, HTTP 서버는 요청·응답 검증과 프로세스 종료를 확인해야 한다. 소스에서 직접 빌드하는 환경에는 Rust 1.97.0 요구사항도 적용된다.

다음 그림은 배포 형태에 따라 어떤 검증으로 연결되는지 보여 준다. 한 서비스가 여러 경로에 해당하면 해당 검증을 함께 수행한다.

⤢✕Wasmtime 50.0.0 업그레이드CLI 실행비동기 컴포넌트HTTP 서버소스 빌드WASIp0와 Winch 기본값취소와 핸들 수명HTTP 검증과 프로세스 종료Rust 1.97.0

업그레이드 검증에서는 정상 요청의 성공만으로 판단하지 않는다. 이번 릴리스에는 취소, 상대편 핸들 해제, 잘못된 헤더, 출력 예산, graceful shutdown처럼 정상 처리 경로 바깥의 변경이 포함돼 있다.

WASIp0와 Winch는 지원 여부와 기본값을 따로 본다

WASIp0 변경의 적용 대상은 Wasmtime CLI다. 기존 실행 대상에서 wasi_unstable 의존 여부를 확인하고, 의존하는 모듈은 실행 설정에 다음 활성화 옵션을 반영할지 검토한다.

-Spreview0

이 옵션은 릴리스노트에 명시된 WASIp0 활성화 수단이다. 모든 실행 대상에 일괄 추가하기보다 WASIp0가 필요한 모듈과 연결해 관리하면, 어떤 배포가 해당 호환성 설정을 요구하는지 확인하기 쉽다.

Winch에서는 지원 기능이 늘어난 동시에 기본 활성화 범위가 줄었다. x86_64와 AArch64에 tail-call 지원이 추가됐지만, GC 타입·예외·tail-call 제안은 지원 수준이 아직 Tier 1이 아니어서 기본 비활성화된다. 따라서 “해당 아키텍처에서 지원한다”는 사실만으로 기존 실행 설정을 유지해도 된다고 판단해서는 안 된다.

점검 대상 릴리스에 명시된 변경 운영자가 확인할 내용
CLI의 WASIp0 기본 비활성화, -Spreview0로 활성화 가능 wasi_unstable 의존 모듈과 실행 옵션
Winch의 GC 타입·예외 기본 비활성화 해당 제안을 사용하는 실행 대상과 설정
Winch의 tail-call x86_64·AArch64 지원 추가, 기본 비활성화 대상 아키텍처의 지원 여부와 활성화 설정
소스 빌드 Rust 1.97.0 요구 로컬·CI·배포 빌드의 Rust 버전

직접 빌드한 실행 파일을 배포한다면 Rust 요구사항을 빌드 환경에서 먼저 확인한다. 임베딩 코드를 수정하는 작업과 빌드 도구 버전 변경을 구분해 두면, 컴파일 실패가 도구 요구사항 때문인지 API 변경 때문인지 좁혀 볼 수 있다.

비동기 컴포넌트는 취소와 핸들 수명을 다시 검증한다

component-model-async는 명세 갱신에 따라 관찰 가능한 동작이 바뀌었다. 특히 취소를 요청한 뒤의 처리와 상대편이 해제된 stream/future 핸들의 사용을 별도 검증 대상으로 잡아야 한다.

릴리스노트에 명시된 변경은 다음과 같다.

  • intrinsic에서 cancellable immediate가 제거됐다.
  • subtask.cancel의 의미가 조정됐다.
  • task.cancel은 취소 이벤트가 전달되기 전에 trap한다.
  • 반대쪽 끝이 해제된 stream/future 핸들을 사용하면 trap한다.

취소 이벤트를 받는 경로만 검사하면 task.cancel의 trap 시점을 놓칠 수 있다. 기존 취소 처리에서 이벤트 수신과 trap 처리를 어떻게 관찰하는지 확인하고, 종료된 상대편과 연결된 핸들을 다시 사용하는 경로도 검사한다.

아래 그림은 취소와 핸들 수명에서 검증해야 할 동작을 구분한다. 두 경로를 하나의 취소 처리 결과로 묶지 않는 것이 핵심이다.

⤢✕취소와 핸들 수명task.cancel취소 이벤트 전달 전 trapstream/future 핸들반대쪽 끝 해제핸들 사용trap

임베딩 코드에도 변경이 있다. Accessor::spawn은 이제 AccessorTask 대신 async closure를 받는다. 해당 API를 사용하는 코드는 호출부를 갱신하고, 그 호출부와 연결된 취소·완료 경로를 함께 확인해야 한다.

스케줄링과 호출 비용 관련 변경은 호환성 검증 후에 관찰할 항목이다. 동시 작업 중 다른 호스트 태스크가 굶지 않도록 주기적으로 yield하며, async guest-to-host 호출은 호스트 태스크를 지연 생성하도록 개선됐다. sync-to-sync 어댑터도 많은 경우 {enter,exit}-sync-call 호출이 필요 없어졌다.

릴리스노트에는 이 변경들의 성능 수치가 없다. 따라서 일정한 지연 감소나 처리량 증가를 전제로 용량을 조정하지 말고, 취소·핸들 동작을 확인한 뒤 실제 작업 부하에서 영향을 측정한다.

게스트에서 호스트로 들어온 호출을 대응하는 호스트에서 게스트로 나간 호출과 연결해야 하는 임베더는 새 task-group-hook 기능을 검토할 수 있다. 이 기능은 기본 비활성화이므로, 해당 연결이 필요한 환경에서 활성화 여부를 결정한다.

serve 옵션은 소켓과 프로세스 수명을 나눠 적용한다

wasmtime serve에는 서비스 매니저의 리스닝 소켓 상속, Unix 소켓 제공, 유휴 상태 자동 종료 기능이 추가됐다. 각각 연결을 받는 방식과 프로세스가 살아 있는 기간에 관여하므로 적용 목적을 구분해야 한다.

릴리스노트에 명시된 옵션 이름은 다음과 같다.

--systemd-listenfd
--idle-process-timeout

--systemd-listenfd는 systemd socket unit 같은 서비스 매니저에서 리스닝 소켓을 상속받는 용도다. --idle-process-timeout은 유휴 상태에서 프로세스가 자동 종료되도록 하는 용도다. Unix 소켓으로 서비스하는 기능도 추가됐지만, 제공된 릴리스노트에는 주소 표기법이나 전체 실행 예시가 없다.

운영 요구 사용할 기능 적용 시 확인할 경로
서비스 매니저가 제공하는 소켓 사용 --systemd-listenfd 상속받은 리스닝 소켓으로 서비스하는 경로
Unix 소켓으로 서비스 제공 Unix 소켓 지원 실제 배포에서 사용하는 연결 경로
유휴 상태에서 프로세스 종료 --idle-process-timeout 유휴 종료와 이후 서비스 재개 절차
정상 종료 처리 graceful shutdown 수정 요청 처리 중 종료를 포함한 기존 종료 절차

유휴 종료를 적용한다면 종료 자체뿐 아니라 이후 서비스를 어떻게 다시 시작할지도 배포 절차에서 확인한다. 소켓 상속 기능이 있다는 사실만으로 모든 재시작 동작까지 검증된 것은 아니다.

이번 릴리스에는 wasmtime serve의 graceful shutdown 수정도 포함된다. 기존 종료 절차를 다시 실행해 보고, 유휴 종료 옵션을 도입한다면 그 경로도 별도로 확인한다.

다음 비교도는 연결 수용 방식과 종료 방식이 서로 다른 운영 결정임을 보여 준다.

⤢✕ wasmtime serve의 연결과 종료 결정 비교 축: 운영 관심사 / 기능 / 확인할 경로 연결 수용 운영 관심사 서비스 매니저의 리스닝 소켓 상속 기능 --systemd-listenfd 확인할 경로 상속받은 리스닝 소켓으로 서비스하는 경로 운영 관심사 Unix 소켓 제공 기능 Unix 소켓 지원 확인할 경로 실제 배포에서 사용하는 연결 경로 프로세스 종료 운영 관심사 유휴 상태 자동 종료 기능 --idle-process-timeout 확인할 경로 유휴 종료와 이후 서비스 재개 절차 운영 관심사 정상 종료 처리 기능 graceful shutdown 수정 확인할 경로 요청 처리 중 종료를 포함한 기존 종료 절차 Wasmtime 50.0.0 업그레이드: 호환성과 서버 운영 점검 | infra-system

HTTP 검증 변경을 회귀 검사에 넣는다

wasi:http 변경은 응답 본문 길이, 헤더, trailers, 출력 스트림 예산에 걸쳐 있다. 정상 응답만 보내 보는 검사로는 이 범위를 확인하기 어렵다. 기존 HTTP 회귀 검사에 길이 불일치와 중복 헤더, 출력 예산 관련 사례가 있는지 확인한다.

특히 p3에 명시된 수정과 일반 wasi:http 수정을 구분해야 한다.

적용 대상 변경 내용 검사에 포함할 사례
wasi-http p3 응답 본문 content-length 강제 적용 수정 선언된 길이와 본문 길이가 다른 응답
wasi-http p3 trailers 금지 헤더 검사 적용 trailers에 금지 헤더가 포함된 경우
wasi-http 헤더 중복 content-length 금지 content-length가 중복된 경우
wasi:http outgoing body와 일부 wasi:io 출력 스트림 check-write 예산 강제 적용 예산을 넘는 쓰기 경로
wasi:http의 path-with-query 빈 값 항상 허용 빈 path-with-query를 사용하는 경우

자료에는 길이 불일치나 금지 헤더에 대한 구체적인 오류 문자열이 없다. 검사 기대값을 작성할 때도 릴리스노트에 없는 오류 메시지를 고정하지 말고, 실제 실행 결과와 명시된 제약이 맞는지 확인해야 한다.

CLI 설정에는 별도 호환성 점검이 필요하다. --http-outgoing-body-* 옵션은 이제 값으로 0을 거부한다. 기존 설정에 0이 들어 있다면 업그레이드 전에 확인해야 한다. 제공된 자료에는 대체값의 의미가 없으므로 다른 값을 임의로 지정해서는 안 된다.

또한 wasmtime run이 해당 옵션을 준수하도록 수정됐다. run으로 HTTP 동작을 검증하는 환경은 옵션을 전달했다는 사실에 그치지 말고, 적용된 동작까지 확인한다.

기본 wasi:http 훅은 연결 오류와 TLS 오류를 더 세밀하게 분류한다. 오류 분류를 기준으로 운영 기록이나 검증 결과를 해석하는 환경이라면 변경된 분류도 확인 대상이다. 구체적인 오류 이름은 릴리스노트에 제시돼 있지 않다.

임베딩 코드는 콜백 접근 범위와 메모리 회수를 구분한다

Epoch deadline과 call-hook 콜백은 이제 StoreContextMut 대신 StoreHookState를 받는다. 이 상태에서 접근할 수 있는 범위는 Store<T>의 T로 제한된다. 해당 콜백을 사용하는 코드는 매개변수 타입 변경과 함께 콜백 내부의 접근 대상을 확인해야 한다.

메모리 관련 변경도 서로 다른 대상을 다룬다. 컴파일 사이에 캐시된 컴파일러 컨텍스트를 버려 지속적인 메모리 사용량을 줄이는 변경과, pooling allocator의 유휴 슬롯 메모리를 회수하는 새 API를 같은 기능으로 취급하지 않는다.

대상 변경 또는 API 임베더의 적용 판단
컴파일러 컨텍스트 모듈·컴포넌트 컴파일 사이에 캐시된 컨텍스트 해제 반복 컴파일 작업에서 메모리 사용 관찰
pooling allocator의 유휴 슬롯 Engine::release_idle_pool_memory 추가 유휴 슬롯에 상주하는 메모리의 명시적 회수가 필요한지 판단
Store의 GC heap Store::gc_heap_grow 추가 GC heap을 수동으로 확장할 필요가 있는지 판단
게스트 리소스 해제 ResourceAny::resource_drop_concurrent 추가 Accessor만 있는 위치에서 해제가 필요한지 판단

새 메모리 API가 추가됐다고 모든 임베더에 호출을 넣을 필요는 없다. 현재 제어하려는 대상이 컴파일 캐시인지, pooling allocator의 유휴 슬롯인지, Store의 GC heap인지 먼저 구분한 뒤 해당 API를 검토한다.

Fuel을 실행 예산으로 사용하는 환경도 기존 기대값을 다시 확인해야 한다. Val을 통한 더 많은 호스트 할당에 fuel이 부과되며, Cranelift의 call_ref와 예외 catch 주변 fuel 저장·복원, 모듈 start 함수에서 누락되던 버퍼링된 fuel 부과가 수정됐다. 같은 작업 부하에서 예산 소진 결과를 비교하되, 릴리스노트에 없는 증가 폭을 가정하지 않는다.

배포 승인은 변경된 경로의 관찰 결과로 판단한다

이번 업그레이드의 승인 기준은 새 실행 파일로 정상 요청이 성공한다는 사실보다 구체적이어야 한다. 실제 사용하는 기능에 맞춰 다음 결과를 확보한다.

  • wasi_unstable 의존 모듈의 실행 옵션을 확인했고, Winch를 쓴다면 필요한 제안의 활성화 설정을 검증했다.
  • 비동기 컴포넌트의 취소와 상대편 해제 후 핸들 사용을 검사했고, Accessor::spawn 사용 코드를 갱신했다.
  • HTTP 길이·헤더·출력 예산과 0을 사용하는 CLI 설정을 점검했다.
  • serve의 기존 종료 절차를 확인했고, 새 소켓·유휴 종료 기능을 도입했다면 해당 경로도 검증했다.
  • 직접 빌드하거나 임베딩하는 환경에서 Rust 1.97.0 요구사항과 콜백 API 변경을 반영했다.

이 검증을 마친 뒤 성능과 메모리 변화를 측정하면, 기본값 변경으로 생긴 호환성 문제와 런타임 개선의 효과를 구분해 판단할 수 있다. 배포 기록에는 활성화한 옵션과 함께 취소·HTTP 검증·종료 경로의 관찰 결과를 남긴다.

WasmtimeWebAssemblyWASI서버운영업그레이드