Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Shell admin sesi streaming

Gunakan CreateStreamSessionAdminShellAPI untuk terhubung ke lingkungan runtime langsung sesi streaming Anda. Gunakan koneksi terminal untuk memecahkan masalah aplikasi dengan memeriksa log, memeriksa proses yang sedang berjalan, memeriksa pemanfaatan GPU, dan men-debug status aplikasi Anda secara real time.

Prasyarat

Sebelum Anda terhubung ke sesi streaming dengan shell admin, instal plugin AWS Systems Manager Session Manager untuk file AWS Command Line Interface. Plugin diperlukan untuk membuka koneksi terminal. Untuk petunjuk penginstalan, lihat Menginstal plugin Session Manager untuk AWS Command Line Interface.

Contoh kode di bawah ini memerlukan jq, prosesor JSON baris perintah, untuk mengekstrak nilai dari respons API.

Sesi streaming harus dalam salah satu status berikut:ACTIVE,, CONNECTEDPENDING_CLIENT_RECONNECTION, atauRECONNECTING.

Connect menggunakan plugin Session Manager untuk AWS Command Line Interface

Gunakan AWS CLI untuk meminta kredensi akses shell admin, lalu gunakan plugin Session Manager AWS Command Line Interface untuk membuat koneksi terminal. Gunakan contoh kode berikut untuk menghubungkan. Ganti STREAM_GROUP_IDSTREAM_SESSION_ID,, dan REGION dengan nilai-nilai Anda.

AWS Command Line Interface dengan skrip Bash

#!/bin/bash
# GameLift Streams session with admin shell script
# This script sets up a terminal connection to an Amazon GameLift Streams session
# using the AWS Systems Manager Session Manager Plugin

# Stream group ARN or ID owning the session
STREAM_GROUP_ID="arn:aws:gameliftstreams:us-west-2:123456789012:streamgroup/sg-1AB2C3De4"

# Stream session ARN or ID to connect to
STREAM_SESSION_ID="arn:aws:gameliftstreams:us-west-2:123456789012:streamsession/sg-1AB2C3De4/44wOYoDXlRbtf"

# AWS Region where you created the stream group (primary location)
REGION="us-west-2"

# Request admin shell access
SESSION_ACCESS=$(aws gameliftstreams create-stream-session-admin-shell \
    --identifier "${STREAM_GROUP_ID}" \
    --stream-session-identifier "${STREAM_SESSION_ID}" \
    --region "${REGION}" \
    --output json)

# Extract session ID and connect using Session Manager plugin
SESSION_ID=$(echo "$SESSION_ACCESS" | jq -r .SessionId)

# Connect using the API response (the plugin extracts StreamUrl and TokenValue)
# The connection URL expires 60 seconds after the API response.
session-manager-plugin \
    "$SESSION_ACCESS" \
    "${REGION}" \
    "StartSession" \
    "" \
    "{\"Target\":\"$SESSION_ID\"}" \
    "https://ssm.${REGION}.api.aws"

Jika Anda mengalami kesulitan membuat koneksi terminal, lihat solusi Streaming masalah shell admin sesi untuk kesalahan umum.

Streaming masalah shell admin sesi

Bagian ini mengidentifikasi potensi penyebab dan solusi untuk masalah yang terkait dengan penggunaan CreateStreamSessionAdminShellAPI untuk membuka koneksi terminal yang aman ke lingkungan runtime langsung sesi streaming Anda.

Koneksi terminal belum tersedia

Jika Anda menelepon CreateStreamSessionAdminShell dan menerima StreamSessionAccessNotReadyException (HTTP 409), koneksi terminal ke lingkungan runtime langsung sesi Amazon GameLift Streams Anda belum dapat disediakan.

Untuk menyelesaikan masalah ini:

Akses ditolak saat membuat shell admin

Jika Anda memanggil CreateStreamSessionAdminShell dan menerima kesalahan AccessDeniedException (HTTP 403), identitas IAM panggilan tidak memiliki izin yang diperlukan. Untuk mengatasi masalah ini, verifikasi bahwa identitas IAM memiliki gameliftstreams:CreateStreamSessionAdminShell izin untuk sumber daya grup aliran target.

Tidak dapat terhubung ke sesi streaming yang tidak aktif

Jika Anda memanggil CreateStreamSessionAdminShell dan menerima kesalahan ResourceNotFoundException (HTTP 404) atau ValidationException (HTTP 400), verifikasi bahwa grup streaming yang menghosting sesi streaming dalam ACTIVE status dan sesi streaming berada di salah satu status berikut:ACTIVE,, CONNECTEDPENDING_CLIENT_RECONNECTION, atauRECONNECTING.

Untuk menyelesaikan masalah ini:

StreamUrl telah kedaluwarsa

Jika Anda terhubung ke WebSocket titik akhir yang dikembalikan oleh CreateStreamSessionAdminShell dan menerima kesalahan koneksi, StreamUrl telah kedaluwarsa. Ini berlaku selama 60 detik setelah Anda menerimanya. Jika Anda tidak membuat koneksi dalam waktu itu, URL kedaluwarsa.

Untuk menyelesaikan masalah ini:

Plugin Session Manager tidak diinstal

Jika Anda mencoba untuk terhubung menggunakan kredensil yang dikembalikan oleh CreateStreamSessionAdminShell dan koneksi gagal dengan pesan yang menunjukkan plugin Session Manager hilang, Anda perlu menginstal plugin AWS Systems Manager Session Manager untuk CLI AWS .

Untuk menyelesaikan masalah ini:

Shell admin ditutup secara tak terduga

Jika koneksi terminal Anda terputus secara tiba-tiba selama penggunaan, mungkin telah ditutup karena salah satu alasan berikut:

Untuk menyelesaikan masalah ini: