기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon SageMaker Studio Classic의 문제 해결
**중요**
2023년 11월 30일부로 이전 Amazon SageMaker Studio 경험의 이름이 Amazon SageMaker Studio Classic으로 변경되었습니다. 다음 섹션은 Studio Classic 애플리케이션 사용에 관해 다룹니다. 업데이트된 Studio 환경 사용에 대한 자세한 내용은 [Amazon SageMaker Studio](studio-updated.md) 섹션을 참조하세요.
Studio Classic은 기존 워크로드에 대해 여전히 유지 관리되지만 더 이상 온보딩에 사용할 수 없습니다. 기존 Studio Classic 애플리케이션만 중지하거나 삭제할 수 있으며 새 애플리케이션을 생성할 수는 없습니다. [워크로드를 새 Studio 환경으로 마이그레이션하는](studio-updated-migrate.md) 것이 좋습니다.
**중요**
Amazon SageMaker Studio 또는 Amazon SageMaker Studio Classic에서 Amazon SageMaker 리소스를 만들도록 허용하는 사용자 지정 IAM 정책은 해당 리소스에 태그를 추가할 수 있는 권한도 부여해야 합니다. Studio와 Studio Classic은 만드는 리소스에 태그를 자동으로 지정하기 때문에 리소스에 태그를 추가할 권한이 필요합니다. IAM 정책이 Studio 및 Studio Classic에서 리소스를 만들도록 허용하지만 태그 지정은 허용하지 않는 경우 리소스 만들기를 시도할 때 'AccessDenied' 오류가 발생할 수 있습니다. 자세한 내용은 [SageMaker AI 리소스 태그 지정을 위한 권한 제공](security_iam_id-based-policy-examples.md#grant-tagging-permissions) 섹션을 참조하세요.
SageMaker 리소스를 만들 수 있는 권한을 부여하는 [AWS Amazon SageMaker AI에 대한 관리형 정책](security-iam-awsmanpol.md)에는 해당 리소스를 만드는 동안 태그를 추가할 수 있는 권한이 이미 포함되어 있습니다.
이 항목에서는 설정 및 사용 중에 발생하는 일반적인 Amazon SageMaker Studio Classic 문제를 해결하는 방법을 설명합니다. 다음은 Amazon SageMaker Studio Classic을 사용하는 동안 발생할 수 있는 일반적인 오류입니다. 각 오류 다음에는 해당 해결 방법이 나와 있습니다.
## Studio Classic 애플리케이션 문제
Studio Classic 애플리케이션을 시작하고 사용할 때 다음과 같은 문제가 발생합니다.
+ **화면이 로드되지 않음: WorkSpace를 지우고 기다려도 도움이 되지 않음**
Studio Classic 애플리케이션을 시작하면 팝업에 다음 메시지가 표시됩니다. 어떤 옵션을 선택하더라도 Studio Classic이 로드되지 않습니다.
```
Loading...
The loading screen is taking a long time. Would you like to clear the workspace or keep waiting?
```
Studio Classic 워크스페이스에 여러 탭이 열려 있거나 Amazon EFS에 여러 파일이 있는 경우 Studio Classic 애플리케이션 시작이 지연될 수 있습니다. 이 팝업은 Studio Classic 워크스페이스가 준비되고 몇 초 후에 사라집니다.
옵션 중 하나를 선택한 후에도 스피너가 있는 로딩 화면이 계속 표시되면 Studio Classic에서 사용하는 Amazon Virtual Private Cloud에 연결 문제가 있을 수 있습니다.
Studio Classic에서 사용하는 Amazon Virtual Private Cloud(Amazon VPC)의 연결 문제를 해결하려면 다음 네트워킹 구성을 확인하세요.
+ 도메인이 `VpcOnly` 모드로 설정된 경우:에 대한 Amazon VPC 엔드포인트 AWS STS또는 인터넷을 통한 트래픽을 포함한 아웃바운드 트래픽에 대한 NAT 게이트웨이가 있는지 확인합니다. 이렇게 하려면 [VPC의 Studio 노트북을 외부 리소스에 연결](studio-notebooks-and-internet-access.md)의 단계를 따르세요.
+ Amazon VPC가 Amazon에서 제공하는 DNS 대신 사용자 지정 DNS로 설정된 경우: Studio Classic에서 사용하는 Amazon VPC에 추가된 각 Amazon VPC 엔드포인트에 대해 DHCP(Dynamic Host Configuration Protocol)를 사용하여 경로가 구성되어 있는지 확인하세요. 기본 및 사용자 지정 DHCP 옵션 세트 설정에 대한 자세한 내용은 [Amazon VPC의 DHCP 옵션 세트](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html)를 참조하세요.
+ **Studio Classic 시작 시 **내부 오류** 발생**
Studio Classic을 시작할 때 Studio Classic UI를 볼 수 없습니다. 또한 다음과 비슷한 오류가 표시되며, **내부 오류**가 오류 세부 정보로 표시됩니다.
```
Amazon SageMaker Studio
The JupyterServer app default encountered a problem and was stopped.
```
이 오류는 여러 요인으로 인해 발생할 수 있습니다. 이 단계를 완료해도 문제가 해결되지 않는 경우 https://aws.amazon.com/premiumsupport/로 이슈를 생성하세요.
+ **Amazon EFS 마운트 대상 누락**: Studio Classic은 Amazon EFS를 스토리지로 사용합니다. Amazon EFS 볼륨에는 Amazon SageMaker AI 도메인이 생성되는 각 서브넷에 대한 마운트 대상이 필요합니다. 이 Amazon EFS 마운트 대상이 실수로 삭제되면 사용자의 파일 디렉터리를 마운트할 수 없으므로 Studio Classic 애플리케이션을 로드할 수 없습니다. 다음 단계에 따라 문제를 해결하세요.
**마운트 대상을 확인하거나 생성하기 위해서입니다.**
1. [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html) API 호출을 사용하여 도메인과 연결된 Amazon EFS 볼륨을 찾을 수 있습니다.
1. 에 로그인 AWS Management Console 하고 [ https://console.aws.amazon.com/efs/](https://console.aws.amazon.com/efs/) Amazon EFS 콘솔을 엽니다.
1. Amazon EFS 볼륨 목록에서 도메인과 연결된 Amazon EFS 볼륨을 선택합니다.
1. Amazon EFS 세부 정보 페이지에서 **네트워크** 탭을 선택합니다. 도메인이 설정된 모든 서브넷에 대해 마운트 대상이 있는지 확인하세요.
1. 마운트 대상이 없는 경우 누락된 Amazon EFS 마운트 대상을 추가하세요. 지침은 [마운트 대상 및 보안 그룹 생성 및 관리](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)를 참조하세요.
1. 누락된 마운트 대상을 만든 후 Studio Classic 애플리케이션을 시작하세요.
+ **사용자 `.local`폴더의 파일 충돌**: Studio Classic에서 JupyterLab 버전 1을 사용하는 경우 `.local` 폴더의 라이브러리 충돌로 인해 Studio Classic 애플리케이션을 시작할 때 문제가 발생할 수 있습니다. 이 문제를 해결하려면 사용자의 기본 JupyterLab 버전을 JupyterLab 3.0으로 업데이트하세요. JupyterLab 버전 확인 및 업데이트에 대한 자세한 내용은 [Amazon SageMaker Studio Classic에서 JupyterLab 버전 관리](studio-jl.md)을 참조하세요.
+ **Studio Classic 시작 시 **ConfigurationError: LifecycleConfig****
Studio Classic을 시작할 때는 Studio Classic UI를 볼 수 없습니다. 이는 도메인에 연결된 기본 수명 주기 구성 스크립트에 문제가 있기 때문입니다.
**수명 주기 구성 문제를 해결하려면**
1. 수명 주기 구성에 대한 Amazon CloudWatch Logs를 보고 실패를 일으킨 명령을 추적하세요. 로그를 보려면 [CloudWatch Logs에서 수명 주기 구성 프로세스 확인](studio-lcc-debug.md#studio-lcc-debug-logs)의 단계를 따르세요.
1. 사용자 프로필 또는 도메인에서 기본 스크립트를 분리합니다. 자세한 내용은 [Amazon SageMaker Studio Classic에서 수명 주기 구성 업데이트 및 분리](studio-lcc-delete.md) 섹션을 참조하세요.
1. Studio Classic 애플리케이션을 시작합니다.
1. 수명 주기 구성 스크립트를 디버깅하세요. 시스템 터미널에서 수명 주기 구성 스크립트를 실행하여 문제를 해결할 수 있습니다. 터미널에서 스크립트가 성공적으로 실행되면 스크립트를 사용자 프로필 또는 도메인에 연결할 수 있습니다.
+ **SageMaker Studio Classic의 핵심 기능을 사용할 수 없습니다.**
Studio Classic을 열 때 이 오류 메시지가 표시되면 Python 패키지 버전 충돌 때문일 수 있습니다. 이 문제는 노트북이나 터미널에서 다음 명령을 사용하여 SageMaker AI 패키지 종속성과 버전이 충돌하는 Python 패키지를 설치한 경우 발생합니다.
```
!pip install
```
```
pip install --user
```
다음 단계에 따라 문제를 해결하세요.
1. 최근에 설치한 Python 패키지를 제거합니다. 어떤 패키지를 제거해야 할지 잘 모르겠으면 https://aws.amazon.com/premiumsupport/로 이슈를 생성하세요.
1. Studio Classic 재시작:
1. **파일** 메뉴에서 Studio Classic을 종료합니다.
1. 1분 정도 기다려 주세요.
1. 페이지를 새로 고치거나 AWS Management Console에서 열어 Studio Classic을 다시 엽니다.
충돌을 일으킨 패키지를 제거한 경우 문제가 해결되어야 합니다. 이 문제를 다시 발생시키지 않고 패키지를 설치하려면 `--user`플래그 없이 `%pip install`를 사용하세요.
문제가 지속되면 새 사용자 프로필을 생성하여 해당 사용자 프로필로 환경을 설정하세요.
이러한 해결 방법으로도 문제가 해결되지 않으면 https://aws.amazon.com/premiumsupport/로 이슈를 생성하세요.
+ ** AWS Management Console에서 Studio Classic을 열 수 없습니다.**
Studio Classic을 열 수 없고 모든 기본 설정을 사용하여 실행 중인 새 인스턴스를 만들 수 없는 경우 https://aws.amazon.com/premiumsupport/로 이슈를 만드세요.
## KernelGateway 애플리케이션 문제
다음 문제는 Studio Classic에서 실행되는 KernelGateway 애플리케이션에만 해당됩니다.
+ **커널 세션에 액세스할 수 없습니다**
사용자가 새 노트북을 시작하면 노트북 세션에 연결할 수 없습니다. KernelGateway 애플리케이션의 `In Service`상태가 인 경우 사용자는 다음 사항을 확인하여 문제를 해결할 수 있습니다.
+ **보안 그룹 구성 확인**
도메인이 `VPCOnly`모드로 설정된 경우 도메인과 연결된 보안 그룹은 JupyterServer와 KernelGateway 앱 간의 연결을 위해 `8192-65535`범위 내의 포트 간 트래픽을 허용해야 합니다.
**보안 그룹에 규칙을 추가하려면**
1. [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html) API 호출을 사용하여 도메인과 연결된 보안 그룹을 가져옵니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) Amazon VPC 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **보안** 아래의 **보안 그룹**을 선택합니다.
1. 도메인과 연결된 보안 그룹의 ID로 필터링합니다.
1. 각 보안 그룹의 경우:
1. 보안 그룹을 선택합니다.
1. 보안 그룹 세부 정보 페이지에서 **인바운드 규칙**을 확인합니다. 범위 `8192-65535`내 포트 간에 트래픽이 허용되는지 확인하세요.
보안 그룹 규칙에 대한 자세한 내용은 [보안 그룹을 사용하여 리소스에 대한 트래픽 제어](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#working-with-security-group-rules)를 참조하세요. Studio Classic을 `VPCOnly` 모드에서 사용하기 위한 요구 사항에 대한 자세한 내용은 [VPC의 Studio 노트북을 외부 리소스에 연결](studio-notebooks-and-internet-access.md) 섹션을 참조하세요.
+ **방화벽 및 WebSocket 연결 확인**
KernelGateway 앱이 `InService` 상태이고 사용자가 Studio Classic 노트북 세션에 연결할 수 없는 경우 방화벽과 WebSocket 설정을 확인하세요.
1. Studio Classic 애플리케이션을 시작합니다. 자세한 내용은 [Amazon SageMaker Studio Classic 시작](studio-launch.md) 섹션을 참조하세요.
1. 웹 브라우저 개발자 도구 모음을 엽니다.
1. **네트워크** 탭을 선택합니다.
1. 다음 형식과 일치하는 항목을 검색하세요.
```
wss://.studio..sagemaker.aws/jupyter/default/api/kernels//channels?session_id=
```
항목의 상태 또는 응답 코드가 `101` 이외의 코드인 경우 네트워크 설정으로 인해 Studio Classic 애플리케이션과 KernelGateway 앱 간의 연결이 차단되고 있는 것입니다.
이 문제를 해결하려면 네트워킹 설정을 관리하는 팀에 문의하여 Studio Classic URL을 허용하고 WebSocket 연결을 활성화하세요.
+ **리소스 할당량 초과로 인해 앱을 실행할 수 없음**
사용자가 새 노트북을 시작하려고 하면 다음 오류 중 하나로 인해 노트북 생성이 실패합니다. 이는 리소스 할당량을 초과했기 때문입니다.
+
```
Unable to start more Apps of AppType [KernelGateway] and ResourceSpec(instanceType=[]) for UserProfile []. Please delete an App with a matching AppType and ResourceSpec, then try again
```
Studio Classic은 동일한 인스턴스에서 실행 중인 KernelGateway 앱을 최대 4개까지 지원합니다. 이 문제를 해결하려면 다음 중 한 가지 방법을 시도하면 됩니다.
+ 인스턴스에서 실행 중인 기존 KernelGateway 애플리케이션을 삭제한 다음 새 노트북을 다시 시작합니다.
+ 다른 인스턴스 유형에서 새 노트북을 시작합니다.
자세한 내용은 [Amazon SageMaker Studio Classic 노트북의 인스턴스 유형 변경](notebooks-run-and-manage-switch-instance-type.md) 섹션을 참조하세요.
+
```
An error occurred (ResourceLimitExceeded) when calling the CreateApp operation
```
이 경우 계정에는 지정된 인스턴스 유형에서 Studio Classic 애플리케이션을 만들 수 있는 충분한 제한이 없습니다. 이 문제를 해결하려면 [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) Service Quotas 콘솔로 이동합니다. 해당 콘솔에서 `Studio KernelGateway Apps running on instance-type instance`한도 증가를 요청하세요. 자세한 내용은 [AWS 서비스 할당량](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)을 참조하세요.