Pskubectlcompletion

kubectl 자동완성 등록

Import-Module PSKubectlCompletion 후 Register-KubectlCompletion 명령을 실행하면 kubectl의 하위 명령 및 옵션에 대한 탭 완성이 활성화됩니다. 예를 들어 ‘kubectl get p’라고 입력하고 Tab을 누르면 ‘pods’로 자동 완성됩니다.

별칭 설정 지원

kubectl 명령에 자주 사용하는 별칭 ‘k’를 설정할 수 있습니다. Set-Alias k -Value kubectl 명령을 사용하면 더 짧은 명령어로 작업할 수 있으며, 별칭 설정은 Register-KubectlCompletion 이전에 수행해야 합니다.

프로파일에 자동 등록

매번 모듈을 불러오지 않도록 PowerShell 프로파일에 Import-Module PSKubectlCompletion 명령을 추가할 수 있습니다. Add-Content –Path $PROFILE –Value “Import-Module PSKubectlCompletion” 명령을 실행하면 새 셸을 열 때마다 자동으로 모듈이 로드됩니다.

다운로드·설치 방법

PowerShell Gallery에서 모듈을 설치하려면 관리자 권한이 아닌 일반 PowerShell 터미널에서 다음 명령을 실행합니다:

Install-Module -Name PSKubectlCompletion

설치 후에는 다음 단계를 따라 자동완성을 활성화합니다:

1. Import-Module PSKubectlCompletion
2. 선택 사항: Set-Alias k -Value kubectl (별칭 설정)
3. Register-KubectlCompletion

이 과정을 프로파일에 자동화하려면 다음 명령을 실행합니다:

Add-Content –Path $PROFILE –Value “Import-Module PSKubectlCompletion”

기본 사용법/명령어

모듈을 불러오고 자동완성을 등록한 후에는 일반 kubectl 명령을 사용할 때 탭 키를 눌러 자동완성 제안을 받을 수 있습니다. 예를 들어:

• ‘kubectl get ‘ 뒤에 탭을 누르면 get 하위 명령 목록이 표시됩니다.
• ‘kubectl get p’ 뒤에 탭을 누르면 ‘pods’로 자동 완성됩니다.
• ‘kubectl describe pod ‘ 뒤에 탭을 누르면 기존 pod 이름 목록이 표시됩니다.

별칭 ‘k’를 설정한 경우 ‘k get p’와 같이 짧게 입력해도 동일한 자동완성 기능을 사용할 수 있습니다.

지원 환경·시스템 요구사항

이 모듈은 PowerShell 5.1 이상에서 작동합니다. Windows PowerShell 5.1 또는 PowerShell Core 6.x 이상이 설치된 Windows 시스템에서 사용할 수 있습니다. 별도의 Kubernetes 클라이언트 설치가 필요하며, kubectl이 시스템 PATH에 등록되어 있어야 자동완성 대상이 됩니다.

최신 버전·업데이트

최신 버전은 1.0.4이며, 2020년 11월 19일에リリース되었습니다. 이 버전에서 최소 PowerShell 버전이 5.1로 명시되었고, Import-Module 시 자동으로 Register-KubectlCompletion이 호출되도록 개선되었습니다. 현재 이 프로젝트는 활발히 개발되지 않으며, kubectl 자체에 PowerShell 완성이 내장되어 있어 공식적으로 권장되는 대안이 존재합니다.

제한 사항·확인 사항

이 모듈은 Kubernetes 1.18 클라이언트 버전을 기반으로 제작되었으므로, 더 새로운 버전의 kubectl에서 추가된 기능에 대한 완성은 지원하지 않을 수 있습니다. 또한, 이 프로젝트는 현재 활발히 유지보수되지 않으며, 공식 Kubernetes 문서에서 PowerShell용 kubectl 완성을 내장 지원하므로 이를 사용하는 것이 권장됩니다.