הפניה ל-CLI של Migrate to Containers ל-Linux

‫m2c הוא כלי לשורת הפקודה שמאפשר להגדיר ולהריץ העברות במחשב המקומי.

m2c

ממשק שורת פקודה ל-Migrate to Containers.

כדי לבצע מודרניזציה מהירה של עומס העבודה, פועלים לפי ארבעת השלבים הבאים:

  1. מעתיקים את מערכת הקבצים מהמכונה המקורית באופן מקומי.

  2. ניתוח של מערכת הקבצים כדי ליצור תוכנית מודרניזציה.

  3. עורכים את התוכנית כדי להתאים אישית את ארטיפקטים המודרניזציה.

  4. יוצרים את פריטי המידע שנוצרו בתהליך פיתוח (Artifacts) של המודרניזציה.

תקציר

m2c COMMAND [options]

דגלים

-q,--quiet
לא להציג פלט
-v,--verbose
הצגת פלט מפורט

פקודות

פקודה תיאור
m2c analyze ניתוח ההגדרה של עומס העבודה במערכת הקבצים הנתונה.
m2c cleanup לפנות מערכת קבצים של מקור.
m2c completion יצירת סקריפט להשלמה אוטומטית עבור המעטפת שצוינה
m2c config צפייה במאפיינים של מערך הגדרות אישיות ועריכה שלהם
m2c copy העתקה מקומית של מערכת הקבצים של מכונה וירטואלית.
m2c generate יצירת ארטיפקטים של מיגרציה ממערכת הקבצים שצוינה.
m2c help עזרה לגבי כל פקודה
‫m2c migrate-data העברת נתונים מהמחשב המקומי ל-PVC.
m2c plugins ניהול תוספים להעברה
גרסת m2c מדפיסים את גרסת ה-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 mounts a file or directory into the container in the format of "localPath:remotePath". אפשר לציין כמה פעמים

m2c cleanup

מנקים מערכת קבצים של מקור שנוצרה באמצעות פקודת ההעתקה.

תקציר

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.

אם הוא לא מותקן, אפשר להתקין אותו דרך מנהל החבילות של מערכת ההפעלה.

כדי לטעון השלמות בהפעלה הנוכחית של מעטפת הפקודות:

    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
disable completion descriptions

m2c completion fish

יוצרים את סקריפט ההשלמה האוטומטית עבור מעטפת fish.

כדי לטעון השלמות בהפעלה הנוכחית של מעטפת הפקודות:

    m2c completion fish | source

כדי לטעון השלמות לכל סשן חדש, מריצים את הפקודה הבאה פעם אחת:

    m2c completion fish > ~/.config/fish/completions/m2c.fish

כדי שההגדרה הזו תיכנס לתוקף, צריך להפעיל מעטפת חדשה.

תקציר

m2c completion fish

דגלים

--no-descriptions
disable completion descriptions

m2c completion powershell

יצירת סקריפט להשלמה אוטומטית עבור PowerShell.

כדי לטעון השלמות בהפעלה הנוכחית של מעטפת הפקודות:

    m2c completion powershell | Out-String | Invoke-Expression

כדי לטעון השלמות לכל סשן חדש, מוסיפים את הפלט של הפקודה שלמעלה

לפרופיל שלכם ב-PowerShell.

תקציר

m2c completion powershell

דגלים

--no-descriptions
disable completion 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
disable completion descriptions

הגדרות m2c

צפייה במאפיינים של מערך הגדרות אישיות ועריכה שלהם.

תקציר

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

העתקה מקומית של מערכת הקבצים של מכונה וירטואלית.

ההעתקה מתבצעת באמצעות rsync ואפשר לבצע אותה באמצעות gcloud או SSH ישיר.

תקציר

m2c copy COMMAND

פקודות

פקודה תיאור
m2c copy default-filters הצגת מסנני ברירת המחדל של rsync שמשמשים לפעולת ההעתקה
m2c copy gcloud העתקת מערכת קבצים של מכונה וירטואלית ב-Google Cloud באופן מקומי באמצעות gcloud.
m2c copy ssh מעתיקים את מערכת הקבצים של מכונה וירטואלית למחשב המקומי באמצעות SSH.

m2c copy default-filters

הצגת מסנני ברירת המחדל של rsync שמשמשים לפעולת ההעתקה.

אפשר להשתמש בזה כבסיס לקובץ מסננים מותאמים אישית שיועבר באמצעות הדגל ‎--filters.

תקציר

m2c copy default-filters

m2c copy gcloud

העתקת מערכת קבצים של מכונה וירטואלית ב-Google Cloud באופן מקומי באמצעות gcloud.

תקציר

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 החיצוניות שלהן. אפשר להשתמש בכתובת הזו כדי להתחבר ממופע אחד למופע אחר באותה רשת VPC, דרך חיבור VPN, או בין שתי רשתות VPC מקושרות. כדי שהחיבור הזה יפעל, צריך להגדיר את הרשתות ואת חומת האש כך שיתאפשרו חיבורי SSH לכתובת ה-IP הפנימית של המופע שאליו רוצים להתחבר. מידע על השימוש בדגל הזה זמין בכתובת https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances .
-o,--output path
נתיב הפלט של מערכת הקבצים שהועתקה
-p,--project project
פרויקט ב-Google Cloud
--remote-sudo
משתמשים ב-sudo בצד המרוחק של rsync. משתמשים באפשרות הזו אם פרטי הכניסה שמעבירים לא שייכים למשתמש Root. אם לא מריצים את הפקודה כמשתמש על, אי אפשר להעתיק את כל מערכת הקבצים. שווה ערך להעברת --rsync-path 'sudo rsync' אל rsync.
--tunnel-through-iap
העברת חיבור ה-SSH דרך Cloud Identity-Aware Proxy להעברת TCP. מידע נוסף זמין במאמר בנושא IAP להעברת TCP ‏ ( https://cloud.google.com/iap/docs/tcp-forwarding-overview ).
-n,--vm-name name
שם המכונה הווירטואלית
-z,--zone zone
אזור Google Cloud

m2c copy ssh

מעתיקים את מערכת הקבצים של מכונה וירטואלית למחשב המקומי באמצעות SSH.

תקציר

m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]

דגלים

--filters path
הנתיב לקובץ מסנני rsync מותאמים אישית. המדיניות הזו מבטלת את מסנני ברירת המחדל
-i,--identity-file key
קובץ שמכיל את המפתח לאימות
-o,--output path
נתיב הפלט של מערכת הקבצים שהועתקה
--remote-sudo
משתמשים ב-sudo בצד המרוחק של rsync. משתמשים באפשרות הזו אם פרטי הכניסה שמעבירים לא שייכים למשתמש Root. אם לא מריצים את הפקודה כמשתמש על, אי אפשר להעתיק את כל מערכת הקבצים. שווה ערך להעברת --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 mounts a file or directory into the container in the format of "localPath:remotePath". אפשר לציין כמה פעמים

עזרה בנושא m2c

האפשרות Help מספקת עזרה לכל פקודה באפליקציה.

כדי לקבל פרטים מלאים, פשוט מקלידים m2c help [path to command].

תקציר

m2c help [command]

m2c migrate-data

מעבירים נתונים מהמכונה המקומית ל-PVC באשכול שמחובר כרגע, בהתאם לתוכנית להעברת נתונים.

תקציר

m2c migrate-data -i INPUT_PATH [options]

דגלים

-i,--input path
הנתיב לספרייה שנוצרה על ידי m2c analyze
-n,--namespace namespace
מרחב השמות של ה-PVCs של היעד באשכול היעד

פלאגינים של m2c

תקציר

m2c plugins COMMAND

פקודות

פקודה תיאור
m2c plugins unpack ייבוא פלאגינים מקובץ מקומי.

m2c plugins unpack

ייבוא פלאגינים מקובץ מקומי.

כדי להוריד קובץ חבילת פלאגינים, אפשר לעיין במאמר 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
מאגר תגים שזמין לאשכול היעד. תמונות שמשמשות את תהליך העברת הנתונים יידחפו למאגר הזה כדי להבטיח שהעברת הנתונים תפעל בלי לשלוף תמונות מהאינטרנט.

גרסת m2c

מדפיסים את גרסת ה-CLI.

תקציר

m2c version