AWS CLI로 리소스 찾기

소개

보고서 팀은 프로덕션이나 다른 팀의 설정을 변경하지 않고 재무팀의 테스트 설정을 검토해야 합니다. 올바른 리소스를 찾고 목록을 읽기 쉽게 만든 뒤 내보내기 형식을 CSV로 업데이트합니다.

먼저 작업 공간과 리전 리소스 실습을 완료하세요. 새 환경에 CLI 연결과 리소스가 준비되어 있으므로 이전 파일이나 자격 증명이 필요하지 않습니다. 명령에는 Terminal을 사용하고 위쪽 AWS View에서 변경 사항을 관찰하세요.

인증 시험 관련 주제

인증	시험 태스크	실습 내용
Cloud Practitioner (CLF-C02)	태스크 3.1	CLI 리소스 조회와 범위를 지정한 운영 목록.

실습 개요

개념도: 이름 접두사로 재무 팀의 테스트 설정을 조회하고, 별도의 업데이트로 내보내기 형식을 CSV로 변경합니다.

재무팀의 테스트 설정 찾기

이 단계에서는 여러 리소스가 섞인 목록을 이번 검토에 배정된 재무팀 설정으로 좁힙니다.

이전 실습에서 리전으로 지역을 선택하는 방법을 배웠습니다. 여기서는 us-east-1이 기본값으로 준비되어 있으므로 --region이 없는 명령은 이 지역을 사용합니다. --region us-east-1을 명시적으로 지정해도 됩니다.

리소스 인벤토리는 리소스 목록입니다. 준비된 파라미터 인벤토리를 확인하세요.

aws ssm describe-parameters

각 Name과 Description을 살펴보세요. **스테이징(Staging)**은 일상적인 업무가 실행되는 **프로덕션(production)**을 변경하기 전에 사용하는 테스트 환경입니다. 목록에는 재무팀 스테이징, 재무팀 프로덕션, HR 스테이징 설정이 있습니다. 자신의 리소스 두 개는 /labex/inventory/finance/staging/으로 시작합니다.

공식 Console은 파라미터 메타데이터를 리소스 표로 표시합니다. 표의 Name과 Type 열을 describe-parameters가 반환하는 필드와 비교하세요. 예시 이름은 다릅니다. 이 실습은 String 파라미터를 사용합니다.

리소스 이름과 유형을 보여 주는 공식 Parameter Store의 My parameters 표 — 출처: AWS Blog — https://aws.amazon.com/blogs/mt/implement-operations-observability-in-landing-zone-environments/.

목록은 직접 훑어볼 만큼 작지만 필터를 사용하면 범위가 더 명확해집니다. --parameter-filters는 일치하는 레코드를 반환하도록 서비스에 요청합니다. Key=Name은 이름을 선택하고 Option=BeginsWith는 이름의 시작 부분을 비교하며 Values=...는 그 시작 부분을 제공합니다.

aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/

report-format과 report-owner 두 이름이 표시되며 순서는 달라질 수 있습니다. 필터는 이 작업의 리소스를 선택하며 설정을 바꾸지 않습니다.

접두사 필터는 재무팀 스테이징을 선택하고 다른 리소스를 결과에서 제외합니다 — 개념도: 필터는 반환되는 목록을 변경하며 리소스를 변경하지 않습니다. 다른 설정도 여전히 존재합니다.

이름을 표시하고 내보내기 형식 업데이트하기

이 단계에서는 일치하는 이름만 표시한 다음 재무팀 스테이징의 내보내기 형식을 변경합니다.

응답에는 지금 필요한 것보다 많은 필드가 있습니다. --query는 응답의 일부를 선택하며 저장된 데이터를 변경하지 않습니다. 'Parameters[].Name'에서 Parameters[]는 반환된 레코드를 뜻하고 .Name은 그 이름을 선택합니다. 표현식을 작은따옴표로 감싸세요.

기존 필터에 이 선택을 추가하세요.

aws ssm describe-parameters \
  --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ \
  --query 'Parameters[].Name'

응답에는 일치하는 두 이름이 표시됩니다. 필터는 리소스를, 쿼리는 표시할 필드를 선택합니다.

필드 선택은 전체 레코드를 그대로 두고 리소스 이름을 표시합니다 — 개념도: Name을 선택하면 이 응답에서 다른 필드가 숨겨질 뿐 삭제되지는 않습니다.

더 간결하게 표시하려면 --output table을 덧붙이세요.

aws ssm describe-parameters \
  --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ \
  --query 'Parameters[].Name' \
  --output table

같은 두 이름이 표로 표시됩니다. 표현 방식만 달라집니다.

이름으로 정확한 스테이징 형식 설정을 읽으세요.

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format

Value를 찾으세요. 값은 json입니다. 이것은 애플리케이션의 내보내기 형식으로, CLI의 JSON 응답 형식과는 별개입니다. 후속 보고서 가져오기 도구는 CSV가 필요하므로 이 설정을 업데이트하세요.

aws ssm put-parameter \
  --name /labex/inventory/finance/staging/report-format \
  --type String \
  --value csv \
  --overwrite

다시 읽으세요.

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format

값은 이제 csv입니다. AWS View에서 finance staging, production, HR을 비교하세요. staging의 보고서 형식만 변경되었으며 production은 json, HR은 xlsx로 유지됩니다.

설정을 확인하고 검토 마치기

이 단계에서는 대상 출력 형식과 담당 팀을 확인합니다.

단일 리소스에서도 필드 하나를 선택할 수 있습니다. 'Parameter.Value'는 Parameter 안의 값을 읽고 --output text는 JSON 따옴표 없이 표시합니다.

aws ssm get-parameter \
  --name /labex/inventory/finance/staging/report-format \
  --query 'Parameter.Value' \
  --output text

응답은 csv입니다. 이 보고서 설정의 소유자를 확인하세요.

aws ssm get-parameter \
  --name /labex/inventory/finance/staging/report-owner \
  --query 'Parameter.Value' \
  --output text

응답은 finance입니다. 이들은 저장된 값입니다. 앞서 확인한 메타데이터 목록에는 값 대신 이름과 설명이 표시되었습니다.

저장된 값으로 대상 설정을 확인합니다. 형식은 csv, 팀은 finance이며 다른 그룹은 변경되지 않았습니다. 다음에는 이름에 공통 접두사가 없는 리소스를 태그로 묶습니다.

요약

finance staging 설정을 찾고 필요한 필드를 선택하여 대상 형식만 수정했습니다. 다음에는 팀과 환경 태그로 리소스를 정리합니다.

자세한 내용은 AWS 공식 문서를 참고하세요: CLI 서버 측 필터와 클라이언트 측 쿼리.