Linux용 Migrate to Containers CLI 참조

m2c는 로컬 머신에서 마이그레이션을 설정하고 실행할 수 있는 명령줄 도구입니다.

m2c

Migrate to Containers 명령줄 인터페이스입니다.

4단계 여정에 따라 워크로드에 대해 빠른 현대화를 수행합니다.

1. 소스 머신에서 로컬로 파일 시스템을 복사합니다.

2. 파일 시스템을 분석하여 현대화 계획을 만듭니다.

3. 계획을 수정하여 현대화 아티팩트를 맞춤설정합니다.

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