Linux용 Migrate to Containers CLI 참조
m2c
는 로컬 머신에서 마이그레이션을 설정하고 실행할 수 있는 명령줄 도구입니다.
m2c
Migrate to Containers 명령줄 인터페이스입니다.
4단계 여정에 따라 워크로드에 대해 빠른 현대화를 수행합니다.
소스 머신에서 로컬로 파일 시스템을 복사합니다.
파일 시스템을 분석하여 현대화 계획을 만듭니다.
계획을 수정하여 현대화 아티팩트를 맞춤설정합니다.
현대화 아티팩트를 생성합니다.
개요
m2c COMMAND [options]
플래그
-q,--quiet
- 아무 것도 출력하지 않음
-v,--verbose
- 상세 출력 표시
명령어
명령어 | 설명 |
---|---|
m2c analyze | 지정된 파일 시스템에서 워크로드 구성을 분석합니다. |
m2c cleanup | 소스 파일 시스템을 삭제합니다. |
m2c completion | 지정된 셸에 대해 자동 완성 스크립트를 생성합니다. |
m2c config | 구성 속성을 보고 수정합니다. |
m2c copy | VM 파일 시스템을 로컬로 복사합니다. |
m2c generate | 지정된 파일 시스템에서 마이그레이션 아티팩트를 생성합니다. |
m2c help | 모든 명령어에 대한 도움말을 표시합니다. |
m2c migrate-data | 로컬 머신에서 PVC로 데이터를 마이그레이션합니다. |
m2c 플러그인 | 마이그레이션 플러그인 관리 |
m2c version | CLI 버전을 표시합니다. |
m2c analyze
지정된 파일 시스템에서 지정된 플러그인을 사용하여 워크로드 구성을 분석합니다.
그 결과 생성된 현대화 계획은 지정된 출력 디렉터리 아래의 config.yaml 파일에 제공됩니다.
개요
m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]
플래그
-o,--output path
m2c generate
명령어에 대한 입력으로 사용할 수 있는 출력 경로입니다.-r,--parameter name=value
- 'name=value' 형식의 플러그인 분석 매개변수입니다. 여러 번 지정할 수 있습니다.
-p,--plugin name
- 플러그인 이름입니다.
-s,--source path
m2c copy
명령어로 생성된 파일 시스템 경로입니다.--volume localPath:remotePath
- Bind는 파일 또는 디렉터리를 'localPath:remotePath' 형식으로 컨테이너에 마운트합니다. 여러 번 지정할 수 있습니다.
m2c cleanup
copy 명령어로 생성된 소스 파일 시스템을 삭제합니다.
개요
m2c cleanup -s SOURCE
플래그
-s,--source path
m2c copy
로 만든 소스의 경로입니다.
m2c completion
지정된 셸에 대해 m2c의 자동 완성 스크립트를 생성합니다.
생성된 스크립트를 사용하는 방법에 대한 자세한 내용은 각 하위 명령어 도움말을 참조하세요.
개요
m2c completion
명령어
명령어 | 설명 |
---|---|
m2c completion bash | bash에 대해 자동 완성 스크립트를 생성합니다. |
m2c completion fish | fish에 대해 자동 완성 스크립트를 생성합니다. |
m2c completion powershell | powershell에 대해 자동 완성 스크립트를 생성합니다. |
m2c completion zsh | zsh에 대해 자동 완성 스크립트를 생성합니다. |
m2c completion bash
bash 셸에 대해 자동 완성 스크립트를 생성합니다.
이 스크립트는 'bash-completion' 패키지에 따라 달라집니다.
아직 설치하지 않았으면 OS의 패키지 관리자를 통해 설치할 수 있습니다.
현재 셸 세션에서 완료를 로드하려면 다음 안내를 따르세요.
source <(m2c completion bash)
모든 새 세션에 대해 완료를 로드하려면 한 번 실행합니다.
Linux:
m2c completion bash > /etc/bash_completion.d/m2c
macOS:
m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c
이 설정을 적용하려면 새 셸을 시작해야 합니다.
개요
m2c completion bash
플래그
--no-descriptions
- 완료 설명 사용 중지
m2c completion fish
fish 셸에 대해 자동 완성 스크립트를 생성합니다.
현재 셸 세션에서 완료를 로드하려면 다음 안내를 따르세요.
m2c completion fish | source
모든 새 세션에 대해 완료를 로드하려면 한 번 실행합니다.
m2c completion fish > ~/.config/fish/completions/m2c.fish
이 설정을 적용하려면 새 셸을 시작해야 합니다.
개요
m2c completion fish
플래그
--no-descriptions
- 완료 설명 사용 중지
m2c completion powershell
powershell에 대해 자동 완성 스크립트를 생성합니다.
현재 셸 세션에서 완료를 로드하려면 다음 안내를 따르세요.
m2c completion powershell | Out-String | Invoke-Expression
모든 새 세션에 대해 완료를 로드하려면 위 명령의 출력을
powershell 프로필에 추가합니다.
개요
m2c completion powershell
플래그
--no-descriptions
- 완료 설명 사용 중지
m2c completion zsh
zsh 셸에 대해 자동 완성 스크립트를 생성합니다.
셸 완료가 아직 환경에 사용 설정되지 않았으면 이를
사용 설정해야 합니다. 다음을 한 번 실행할 수 있습니다.
echo "autoload -U compinit; compinit" >> ~/.zshrc
현재 셸 세션에서 완료를 로드하려면 다음 안내를 따르세요.
source <(m2c completion zsh)
모든 새 세션에 대해 완료를 로드하려면 한 번 실행합니다.
Linux:
m2c completion zsh > "${fpath[1]}/_m2c"
macOS:
m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c
이 설정을 적용하려면 새 셸을 시작해야 합니다.
개요
m2c completion zsh
플래그
--no-descriptions
- 완료 설명 사용 중지
m2c config
구성 속성을 보고 수정합니다.
개요
m2c config COMMAND
명령어
명령어 | 설명 |
---|---|
m2c config get | 구성 속성의 값을 출력합니다. |
m2c config list | 모든 구성 속성과 해당 값을 출력합니다. |
m2c config set | 구성 속성의 값을 설정합니다. |
m2c config unset | 구성 속성을 기본값으로 재설정합니다. |
m2c config get
구성 속성의 값을 출력합니다.
개요
m2c config get KEY
m2c config list
모든 구성 속성과 해당 값을 출력합니다.
개요
m2c config list
m2c config set
구성 속성의 값을 설정합니다.
개요
m2c config set KEY VALUE
m2c config unset
구성 속성을 기본값으로 재설정합니다.
개요
m2c config unset KEY
m2c copy
VM 파일 시스템을 로컬로 복사합니다.
복사는 rsync를 통해 수행되며 gcloud 또는 직접 SSH를 사용하여 수행할 수 있습니다.
개요
m2c copy COMMAND
명령어
명령어 | 설명 |
---|---|
m2c copy default-filters | 복사 작업에 사용되는 기본 rsync 필터를 표시합니다. |
m2c copy gcloud | gcloud를 통해 Google Cloud VM의 파일 시스템을 로컬로 복사합니다. |
m2c copy ssh | ssh를 통해 VM의 파일 시스템을 로컬 머신에 복사합니다. |
m2c copy default-filters
복사 작업에 사용되는 기본 rsync 필터를 표시합니다.
--filters 플래그를 통해 제공할 커스텀 필터 파일의 기초로 사용할 수 있습니다.
개요
m2c copy default-filters
m2c copy gcloud
gcloud를 통해 Google Cloud VM의 파일 시스템을 로컬로 복사합니다.
개요
m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]
플래그
--filters path
- 커스텀 rsync 필터 파일의 경로입니다. 기본 필터를 재정의합니다.
--internal-ip
- 외부 IP 주소 대신 내부 IP 주소를 사용하여 인스턴스에 연결합니다. VPN 연결을 통해 또는 2개의 피어링된 VPC 네트워크 사이에 동일한 VPC 네트워크에서 한 인스턴스에서 다른 인스턴스로 연결하려고 할 때 이를 사용합니다. 이 연결이 작동하려면 연결하려는 인스턴스의 내부 IP 주소에 대해 SSH 연결을 허용하도록 네트워크 및 방화벽을 구성해야 합니다. 이 플래그 사용 방법은 https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances를 참조하세요.
-o,--output path
- 복사된 파일 시스템의 출력 경로
-p,--project project
- Google Cloud 프로젝트
--remote-sudo
- rsync의 원격 측에서 sudo를 사용합니다.
전달하는 사용자 인증 정보가 루트 사용자를 위한 것이 아니면 이 옵션을 사용합니다.
수퍼유저로 실행하지 않으면 전체 파일 시스템이 복사되지 않습니다.
--rsync-path 'sudo rsync'
를 rsync에 전달하는 것과 같습니다. --tunnel-through-iap
- TCP 전달을 위해 Cloud IAP(Identity-Aware Proxy)를 통해 ssh 연결을 터널링합니다. 자세한 내용은 TCP용 IAP 전달 문서(https://cloud.google.com/iap/docs/tcp-forwarding-overview)를 참조하세요.
-n,--vm-name name
- VM 이름
-z,--zone zone
- Google Cloud 영역
m2c copy ssh
ssh를 통해 VM의 파일 시스템을 로컬 머신에 복사합니다.
개요
m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]
플래그
--filters path
- 커스텀 rsync 필터 파일의 경로입니다. 기본 필터를 재정의합니다.
-i,--identity-file key
- 인증용 키가 포함된 파일입니다.
-o,--output path
- 복사된 파일 시스템의 출력 경로
--remote-sudo
- rsync의 원격 측에서 sudo를 사용합니다.
전달하는 사용자 인증 정보가 루트 사용자를 위한 것이 아니면 이 옵션을 사용합니다.
수퍼유저로 실행하지 않으면 전체 파일 시스템이 복사되지 않습니다.
--rsync-path 'sudo rsync'
를 rsync에 전달하는 것과 같습니다.
m2c generate
지정된 파일 시스템에서 마이그레이션 아티팩트를 생성합니다.
이렇게 하면 이전 분석 작업으로 생성된 마이그레이션 계획 구성이 사용됩니다.
개요
m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]
플래그
-i,--input path
- 'm2c analyze'로 생성된 디렉터리 경로
-o,--output path
- 출력 경로
--volume localPath:remotePath
- Bind는 파일 또는 디렉터리를 'localPath:remotePath' 형식으로 컨테이너에 마운트합니다. 여러 번 지정할 수 있습니다.
m2c help
애플리케이션의 모든 명령어에 대한 도움말을 제공합니다.
전체 세부정보를 보려면 단순히 m2c help [명령어 경로]를 입력합니다.
개요
m2c help [command]
m2c migrate-data
데이터 마이그레이션 계획에 따라 현재 연결된 클러스터의 로컬 머신에서 PVC로 데이터를 마이그레이션합니다.
개요
m2c migrate-data -i INPUT_PATH [options]
플래그
-i,--input path
- m2c analyze로 생성된 디렉터리 경로
-n,--namespace namespace
- 대상 클러스터에 있는 대상 PVC의 네임스페이스
m2c 플러그인
개요
m2c plugins COMMAND
명령어
명령어 | 설명 |
---|---|
m2c 플러그인 압축해제 | 로컬 파일에서 플러그인을 가져옵니다. |
m2c 플러그인 압축해제
로컬 파일에서 플러그인을 가져옵니다.
플러그인 번들 파일을 다운로드하려면 https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration을 참조하세요.
개요
m2c plugins unpack -i,--input PATH [options]
플래그
-i,--input string
- 플러그인 파일의 경로
-r,--registry string
- 대상 클러스터에서 사용할 수 있는 Container Registry입니다. 데이터 마이그레이션 프로세스에 사용되는 이미지는 인터넷에서 이미지를 가져오지 않고도 데이터 마이그레이션 작업을 사용 설정하도록 이 레지스트리에 푸시됩니다.
m2c version
CLI 버전을 표시합니다.
개요
m2c version