이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.
AWS CloudShell에서 StackQL 사용
이 가이드에서는 AWS CloudShell 내에서 StackQL을 사용하는 방법을 보여 줍니다. AWS Console 로그인 세션의 사용자 컨텍스트를 사용하거나 다른 IAM 역할을 수임하여 실행합니다. StackQL은 SQL 구문을 사용하여 클라우드 인프라와 리소스를 쿼리하고 배포할 수 있는 강력한 개발 도구입니다.
테스트 환경 임베디드 SQL 백엔드 linux
AWS CloudShell이란?
AWS CloudShell은 Amazon Web Services(AWS)에서 제공하는 브라우저 기반의 사전 인증된 셸 서비스입니다. 개발자와 IT 전문가는 웹 브라우저에서 직접 클라우드 리소스를 관리할 수 있습니다. AWS CloudShell을 사용하면 로컬 컴퓨터에 AWS CLI(Command Line Interface)를 설치하거나 구성하지 않고도 AWS 서비스 관련 명령을 빠르게 실행할 수 있습니다. 이 서비스는 AWS CLI, Python, Node.js 등 일반적인 개발 및 관리 도구가 미리 설치된 즉시 사용 가능한 환경을 제공하므로, AWS 서비스와 상호 작용하고 작업을 자동화하기가 더 쉬워집니다. AWS CloudShell은 AWS Management Console과 직접 통합되어 있어 관리 작업 실행, AWS 서비스 탐색, 인프라 관리를 원활하게 수행할 수 있습니다. AWS CloudShell은 AWS Console 로그인을 통해 사용자를 자동으로 인증하므로, AWS 계정 컨텍스트에서 명령과 스크립트를 실행하는 과정이 간소화되어 클라우드 운영의 생산성과 효율성이 향상됩니다.
작동 방식
StackQL Linux 패키지에는 주요 클라우드 제공업체의 기본 제공 클라우드 셸 환경에서 stackql 바이너리를 직접 사용할 수 있는 스크립트가 포함되어 있습니다. AWS의 경우 stackql-aws-cloud-shell.sh 스크립트를 사용합니다. stackql-aws-cloud-shell.sh 스크립트의 사용법은 다음과 같습니다.
Usage:
./stackql-aws-cloud-shell.sh [--role-arn ARN] [shell | exec] [flags]
--role-arn (optional)
If supplied, the program will assume the role specified;
if not, then the current user context in the cloud shell will be used.
Command (optional):
'shell' (default) enters the StackQL command shell to execute queries interactively.
'exec' is used to execute StackQL queries or files to provide batch outputs
(such as CSV or JSON output files). If not specified, 'shell' is assumed.
Flags:
optional StackQL flags, documented in Command Line Usage -> Global Flags
stackql-aws-cloud-shell.sh 스크립트는 StackQL용 최신 AWS 프로바이더를 자동으로 다운로드합니다. 포함된 클라우드 셸 스크립트의 소스 코드는 github.com/stackql/cloud-shell-scripts에서 확인할 수 있습니다.
AWS CloudShell에서 stackql Linux 패키지 다운로드
먼저 AWS CloudShell에서 다음 명령을 사용하여 StackQL의 최신 Linux 바이너리를 다운로드합니다.
curl -L https://bit.ly/stackql-zip -O \
&& unzip stackql-zip
이 명령은 stackql 바이너리와 stackql-aws-cloud-shell.sh 스크립트를 AWS CloudShell 환경의 홈 디렉터리에 다운로드하고 압축을 풉니다. 이제 사용할 준비가 되었습니다!
AWS CloudShell에서 stackql shell 명령 사용
AWS CloudShell 내에서 인증된 StackQL 명령 셸을 시작하려면 다음 명령을 실행하기만 하면 됩니다.
sh stackql-aws-cloud-shell.sh
이제 다음과 같이 StackQL 프로바이더를 사용하여 SQL 기반 AWS 쿼리를 대화형으로 실행할 수 있습니다.
StackQL을 사용한 IAM 역할 수임
AWS에서 IAM 역할을 수임하면 기본 사용자 권한으로는 수행할 수 없는 작업을 수행하고 리소스에 액세스할 수 있습니다. 이는 리소스에 임시로 액세스해야 하거나 기본 계정과 다른 권한으로 작업을 수행해야 할 때 특히 유용합니다. StackQL을 사용하면 IAM 역할을 원활하게 수임하여 해당 역할에 부여된 권한으로 AWS 리소스를 쿼리하고 관리할 수 있습니다.
IAM 역할 수임 이해
IAM 역할 수임은 AWS 리소스에 대한 임시 액세스 권한을 안전하게 부여하는 방법입니다. 역할을 수임하면 AWS STS가 임시 보안 자격 증명을 제공하며, 이 자격 증명으로 해당 역할에 사용 권한이 있는 AWS 서비스와 리소스에 액세스할 수 있습니다. 이 메커니즘은 계정 간 액세스, 사용자의 임시 액세스 또는 최소 권한 원칙 준수에 적합합니다.
역할은 AWS Management Console, AWS CLI 또는 AWS SDK를 사용하거나 StackQL 내에서 직접 수임할 수 있습니다. 이를 통해 사용자와 애플리케이션은 필요한 기간 동안 필요한 권한만 갖게 되므로 AWS 환경의 보안 태세가 강화됩니다.
AWS CloudShell에서 StackQL을 사용하여 IAM 역할을 수임하려면 stackql-aws-cloud-shell.sh 스크립트에 --role-arn 옵션을 사용할 수 있습니다. 이 옵션에는 수임할 역할의 Amazon 리소스 이름(ARN)이 필요합니다. 이 옵션을 지정하면 StackQL은 쿼리나 명령을 실행하기 전에 AWS Security Token Service(STS)를 사용하여 지정된 역할을 수임합니다.
sh stackql-aws-cloud-shell.sh --role-arn arn:aws:iam::123456789012:role/YourRoleName
역할을 수임하면 StackQL을 활용하여 기본 사용자가 액세스할 수 없는 AWS 리소스와 상호 작용할 수 있으므로, 클라우드 환경을 더 유연하고 안전하게 관리할 수 있습니다.
수임한 IAM 역할로 StackQL 명령이나 스크립트를 실행할 때는 해당 역할에 원하는 작업을 수행하고 지정된 리소스에 액세스하는 데 필요한 권한이 있는지 확인하세요. 이 방식은 세분화된 액세스 제어를 용이하게 하며 보안 및 거버넌스에 대한 AWS 모범 사례에 부합합니다.
AWS CloudShell에서 stackql exec 명령 실행(배치 작업)
StackQL 쿼리는 exec 명령을 사용하여 실행할 수도 있습니다. 이 방법은 다음과 같은 경우에 유용합니다.
json또는csv같은 대체 출력 형식 지정- StackQL 쿼리 결과에 대한 출력 파일 생성
- 입력 파일(관례상
.iql파일)을 통해 제공되는 StackQL 쿼리 사용 - 변수 로드 또는 쿼리 전처리(
json또는jsonnet사용)를 포함한 복잡한 작업 수행
AWS CloudShell 내에서 exec 명령을 사용하는 예제는 다음과 같습니다.
sh stackql-aws-cloud-shell.sh exec \
--output csv --outfile instances.csv \
"SELECT region, instanceType FROM aws.ec2.instances WHERE region IN ('us-east-1')"
위 예제는 지정된 StackQL 쿼리를 실행하고 출력 CSV 파일을 생성하며, 이 파일은 AWS CloudShell에서 다운로드할 수 있습니다. 또한 --role-arn 인수로 IAM 역할을 지정하여 쿼리나 변경 작업에 다른 역할을 수임할 수 있습니다. 다음은 그 예제입니다(이 예제에서는 입력 파일에서 쿼리를 가져옵니다).
sh stackql-aws-cloud-shell.sh \
--role-arn arn:aws:iam::824532806693:role/SecurityReviewerRole exec \
--infile query.iql \
--output csv --outfile output.csv
exec 명령에 대한 자세한 내용은 여기를 참조하세요.