בדף הזה מפורטות המשימות הבאות:
- צפייה בחבילות ובגרסאות של חבילות ומחיקה שלהן
- הצגה, יצירה, עדכון ומחיקה של תגים
לפני שמתחילים
- אם מאגר היעד לא קיים, צריך ליצור מאגר חדש.
- מוודאים שיש לכם את ההרשאות הנדרשות למאגר.
- הגדרת אימות ל-npm
- (אופציונלי) הגדרת ברירות מחדל לפקודות gcloud.
- אם אתם משתמשים ב-npm credential helper לאימות, צריך לקבל אסימון גישה לפני שמתחברים למאגר באמצעות npm.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול חבילות, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים במאגר:
-
צפייה בחבילות, בקבצים בחבילות ובטגים:
Artifact Registry Reader (
roles/artifactregistry.reader) -
הורדה או התקנה של חבילות:
קורא של Artifact Registry (
roles/artifactregistry.reader) -
כדי להוסיף חבילות למאגר:
Artifact Registry Writer (
roles/artifactregistry.writer) -
מחיקת חבילות:
אדמין של מאגר Artifact Registry (
roles/artifactregistry.repoAdmin)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
קבלת טוקן גישה
אסימוני הגישה תקפים למשך 60 דקות. יוצרים אסימון גישה זמן קצר לפני שמריצים פקודות שיוצרות אינטראקציה עם מאגרי מידע.
כדי לקבל טוקן, אפשר להשתמש באחת מהאפשרויות הבאות:
משתמשים בפקודה
npxכדי לרענן את אסימון הגישה.מוודאים שפרטי הכניסה להתחברות למאגר npm הציבורי נמצאים בקובץ התצורה של npm של המשתמש,
~/.npmrc.מריצים את הפקודה הבאה בספריית הפרויקט של Node.js.
npx google-artifactregistry-authאם מאגר Artifact Registry מוגדר כמאגר הגלובלי והחבילות לא מוגדרות בהיקף, צריך להשתמש בפקודה הבאה כדי שהפקודה תוכל להוריד את כלי העזר לאישורים ממאגר npm הציבורי במקום ממאגר Artifact Registry.
npm_config_registry=https://registry.npmjs.org npx google-artifactregistry-auth
מוסיפים סקריפט לקובץ
package.jsonבפרויקט."scripts": { "artifactregistry-login": "npx google-artifactregistry-auth" }מריצים את הסקריפט בספריית הפרויקט של Node.js.
npm run artifactregistry-login
Artifact Registry קורא את הגדרות המאגר של Artifact Registry בקובץ .npmrc של הפרויקט ומשתמש בהן כדי להוסיף פרטי כניסה של אסימון לקובץ .npmrc של המשתמש. אחסון האסימון בקובץ .npmrc של המשתמש מבודד את פרטי הכניסה מקוד המקור וממערכת בקרת המקור.
הוספת חבילות
מצבי מאגר: רגיל
אפשר לפרסם גרסה ספציפית של חבילה רק פעם אחת. זוהי הגבלה של npm שמטרתה להבטיח שהתוכן של גרסת חבילה שפורסמה יהיה תמיד זהה. כתוצאה מכך, אי אפשר:
- החלפת גרסת חבילה על ידי פרסום שלה מחדש במאגר
- להסיר חבילה או את הגרסה שלה מהמאגר, ואז לפרסם חבילה עם אותו שם ומספר גרסה
אם לא מציינים תג כשמפרסמים חבילה, npm מוסיף את התג latest.
כדי לפשט את ההתקנה של החבילות בשלב פיתוח ספציפי, כדאי לפרסם את החבילות עם תג, כמו beta או dev.
ב-Artifact Registry, שמות החבילות ב-npm צריכים להיות אלפאנומריים ובאותיות קטנות.
כדי להוסיף חבילה:
מוודאים ששם החבילה ב-
package.jsonכולל את ההיקף שהוגדר למאגר. בדוגמה הבאה מוצגת חבילה עם ההיקףdev-repo."name": "@dev-repo/my-package"אם אתם משתמשים בכלי העזר לפרטי הכניסה כדי לבצע אימות באמצעות אסימון גישה, עליכם לקבל אסימון חדש.
מוסיפים חבילות למאגר. אפשר להשתמש בפקודה
npmאוyarn.כדי לתייג את החבילה, כוללים את הדגל
--tagומחליפים את TAG בתג שרוצים להשתמש בו. אם לא כוללים את הדגל--tag, npm מגדיר את התג באופן אוטומטי ל-latest.npm publish --tag=TAGyarn publish --tag TAG
צפייה בחבילות ובגרסאות
מצבי מאגר: רגיל, מרוחק, וירטואלי
כדי לקבל מידע על חבילה באמצעות npm או yarn:
אם אתם משתמשים בכלי העזר לפרטי הכניסה כדי לבצע אימות באמצעות אסימון גישה, עליכם לקבל אסימון חדש.
מריצים את הפקודה המתאימה:
npm viewyarn info
כדי לראות את החבילות ואת גרסאות החבילות באמצעות Google Cloud המסוף או gcloud:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
ברשימת המאגרים, לוחצים על המאגר המתאים.
בדף Packages (חבילות) מופיעה רשימת החבילות במאגר.
לוחצים על חבילה כדי לראות את הגרסאות שלה.
gcloud
כדי להציג את רשימת החבילות במאגר, מריצים את הפקודה הבאה:
gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]
מחליפים את מה שכתוב בשדות הבאים:
-
REPOSITORYהוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל. -
LOCATIONהוא המיקום האזורי או המיקום במספר אזורים של המאגר. אם הגדרתם מיקום ברירת מחדל, תוכלו להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
כדי לראות את הגרסאות של חבילה, מריצים את הפקודה הבאה:
gcloud artifacts versions list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
מחליפים את מה שכתוב בשדות הבאים:
-
PACKAGEהוא המזהה של החבילה או המזהה המלא של החבילה. -
REPOSITORYהוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל. -
LOCATIONהוא המיקום האזורי או המיקום במספר אזורים של המאגר. אפשר להשתמש בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
הצגת חבילות וגרסאות מ Google Cloud מסוף או מ-CLI של gcloud זמינה רק למאגרים רגילים ומרוחקים.
עבור מאגרי מידע מרוחקים, הרשימה שמוחזרת צריכה לכלול את כל התלות הישירה והטרנזיטיבית שנשמרה במטמון במאגר המידע.
מרכיב רשימת קבצים
מצבי מאגר: רגיל, מרוחק
אפשר להציג רשימה של קבצים במאגר, קבצים בכל הגרסאות של חבילה שצוינה או קבצים בגרסה ספציפית של חבילה.
בכל הפקודות הבאות, אפשר להגדיר מספר מקסימלי של קבצים להחזרה על ידי הוספת הדגל --limit לפקודה.
כדי להציג רשימה של כל הקבצים בפרויקט, במאגר ובמיקום שמוגדרים כברירת מחדל כשמוגדרים ערכי ברירת מחדל:
gcloud artifacts files list
כדי לראות את רשימת הקבצים בפרויקט, במאגר ובמיקום שצוינו, מריצים את הפקודה:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION
כדי להציג רשימה של קבצים לכל הגרסאות של חבילה מסוימת:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE
כדי להציג רשימה של קבצים בגרסה ספציפית של חבילה:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--version=VERSION
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--tag=TAG
מחליפים את הערכים הבאים:
-
LOCATION: המיקום האזורי או הרב-אזורי של המאגר. -
PROJECT: Google Cloud מזהה הפרויקט. אם מזהה הפרויקט מכיל נקודתיים (:), כדאי לעיין במאמר בנושא פרויקטים בהיקף הדומיין. -
REPOSITORY: השם של המאגר שבו התמונה מאוחסנת. -
PACKAGE: שם החבילה. -
VERSION: הגרסה של החבילה. -
TAG: התג שמשויך לחבילה.
דוגמאות
כדאי לעיין בפרטי החבילה הבאים:
- פרויקט:
my-project - מאגר:
my-repo - מיקום המאגר:
us-west1 - חבילה:
my-app
הפקודה הבאה מציגה רשימה של כל הקבצים במאגר my-repo במיקום us-west1 בתוך פרויקט ברירת המחדל:
gcloud artifacts files list \
--location=us-west1 \
--repository=my-repo
1.0 של החבילה.
gcloud artifacts files list \
--project=my-project \
--location=us-west1 \
--repository=my-repo \
--package=my-app \
--version=1.0
1.0-dev
gcloud artifacts files list \
--project=my-project \
--location=us-west1 \
--repository=my-repo \
--package=my-app \
--tag=1.0-dev
תיוג חבילות
מצבי מאגר: רגיל
אפשר להציג, להוסיף, לעדכן ולמחוק תגים. תגים יכולים לעזור לכם לנהל גרסאות סמנטיות של החבילות ולייעל את ההתקנה של חבילות בשלב ספציפי של הפיתוח.
לדוגמה, אפשר לתייג את גרסת המועמד הנוכחית עם rc. הצוות שלכם יוכל להתקין את הגרסה הנכונה על סמך התג במקום על סמך מזהה גרסה, וביטול הפרסום של גרסאות טרום-הפצה שלא נעשה בהן שימוש לא ישבור את התלות שלכם בחבילת הגרסה המועמדת להפצה.
צפייה בתגים
כדי לראות את התגים של חבילה:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
לוחצים על החבילה כדי לראות את הגרסאות ואת התגים שמשויכים אליה.
בוחרים את גרסת החבילה שרוצים לתייג.
בשורה של הגרסה שנבחרה, לוחצים על פעולות נוספות (
) ואז על עריכת תגים.מקלידים תגים חדשים בשדה ולוחצים על שמירה.
gcloud
מריצים את הפקודה:
gcloud artifacts tags list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
כאשר:
- PACKAGE הוא שם החבילה במאגר.
- REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
- LOCATION הוא מיקום אזורי או רב-אזורי. משתמשים בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
לדוגמה, כדי להציג את התגים של החבילה my-package במאגר my-repo במיקום ברירת המחדל, מריצים את הפקודה:
gcloud artifacts tags list --package=my-pkg --repository=my-repo
יצירת תגים
אפשר ליצור תג לגרסה ספציפית של חבילה.
כדי לתייג תמונה קיימת במאגר:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
לוחצים על החבילה כדי לראות את הגרסאות שלה.
בוחרים את גרסת החבילה שרוצים לתייג.
בשורה של הגרסה שנבחרה, לוחצים על פעולות נוספות (
) ואז על עריכת תגים.מקלידים תגים חדשים בשדה ולוחצים על שמירה.
gcloud
מריצים את הפקודה הבאה:
gcloud artifacts tags create TAG --package=PACKAGE \
version=VERSION [--location=LOCATION] [--repository=REPOSITORY]
כאשר:
- TAG הוא התג שרוצים להחיל על החבילה.
- PACKAGE הוא שם החבילה במאגר.
- VERSION היא הגרסה של החבילה שרוצים לתייג.
- LOCATION הוא מיקום אזורי או רב-אזורי. משתמשים בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
- REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
לדוגמה, כדי ליצור את התג release-candidate לגרסה 1.0.0 של החבילה my-package במאגר my-repo במיקום ברירת המחדל, מריצים את הפקודה:
gcloud artifacts tags create release-candidate --version=1.0.0 \
--package=my-pkg --repository=my-repo
עדכון תגים
אפשר לשנות תג שמשויך לגרסת חבילה.
כדי לשנות תג קיים:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
לוחצים על החבילה כדי לראות את הגרסאות שלה.
בוחרים את גרסת החבילה עם התג שרוצים לשנות.
בשורה של הגרסה שנבחרה, לוחצים על פעולות נוספות (
) ואז על עריכת תגים.עורכים את התג ולוחצים על שמירה.
gcloud
מריצים את הפקודה הבאה:
gcloud artifacts tags update TAG --package=PACKAGE \
version=VERSION [--location=LOCATION] [--repository=REPOSITORY]
כאשר:
- TAG הוא התג שרוצים להחיל על החבילה.
- PACKAGE הוא שם החבילה במאגר.
- VERSION היא הגרסה של החבילה שרוצים לתייג.
- LOCATION הוא מיקום אזורי או רב-אזורי. משתמשים בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
- REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
לדוגמה, כדי לשנות את התג של גרסה 1.0.0 של החבילה my-package ל-production במאגר my-repo במיקום ברירת המחדל, מריצים את הפקודה:
gcloud artifacts tags update production --version=1.0.0 \
--package=my-pkg --repository=my-repo
ביטול התיוג של גרסאות חבילה
אפשר להסיר תג קיים מגרסת חבילה.
כדי להסיר תג:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
כדי לראות גרסאות של התמונה, לוחצים עליה.
בוחרים את גרסת התמונה שרוצים לבטל את התיוג שלה.
בשורה של הגרסה שנבחרה, לוחצים על פעולות נוספות (
) ואז על עריכת תגים.מוחקים את התג ולוחצים על שמירה.
gcloud
מריצים את הפקודה הבאה:
gcloud artifacts tags delete TAG --package=PACKAGE \
[--location=<LOCATION] [--repository=REPOSITORY]
כאשר:
- TAG הוא התג שרוצים להחיל על החבילה.
- PACKAGE הוא שם החבילה במאגר.
- LOCATION הוא מיקום אזורי או רב-אזורי. משתמשים בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
- REPOSITORY הוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
לדוגמה, כדי להסיר את התג release-candidate מהחבילה my-package במאגר my-repo במיקום ברירת המחדל, מריצים את הפקודה:
gcloud artifacts tags delete release-candidate --package=my-pkg \
--repository=my-repo
התקנת חבילות
מצבי מאגר: רגיל, מרוחק, וירטואלי
כדי להתקין חבילה ממאגר החבילות של Node.js:
אם אתם משתמשים בכלי העזר לפרטי הכניסה כדי לבצע אימות באמצעות אסימון גישה, עליכם לקבל אסימון חדש.
משתמשים בפקודה
npm installאוyarn add.npm
כדי להתקין את הגרסה עם התג
latest:npm install @SCOPE/PACKAGEכדי להתקין גרסה עם תג אחר:
npm install @SCOPE/PACKAGE@TAGכדי להתקין גרסה ספציפית:
npm install @SCOPE/PACKAGE@VERSIONחוטי סריגה
כדי להתקין את הגרסה עם התג
latest:yarn add @SCOPE/PACKAGEכדי להתקין גרסה עם תג אחר:
yarn add @SCOPE/PACKAGE@TAGכדי להתקין גרסה ספציפית:
yarn add @SCOPE/PACKAGE@VERSIONמחליפים את הערכים הבאים:
- SCOPE הוא ההיקף שמשויך למאגר. אם מאגר החבילות של Node.js לא מוגדר עם היקף, משמיטים את
@SCOPE/מהפקודה. - PACKAGE הוא שם החבילה במאגר.
- TAG הוא תג לגרסה שרוצים להתקין.
- VERSION הוא מספר הגרסה שרוצים להתקין.
- SCOPE הוא ההיקף שמשויך למאגר. אם מאגר החבילות של Node.js לא מוגדר עם היקף, משמיטים את
כשמציינים חבילה כתלות ב-package.json, חשוב לכלול את ההיקף של המאגר. בדוגמה הבאה מוצג היקף @dev-repo לחבילה בשם my-package.
"dependencies": {
"@dev-repo/my-package": ">=1.0.0"
}
במאגרי מידע רגילים, מורידים חבילה ישירות ממאגר המידע.
אם המאגר מרוחק, מורידים עותק בקובץ שמור של החבילה ושל התלות שלה. אם אין עותק במטמון, המאגר המרוחק מוריד את החבילה ממקור ה-upstream ושומר אותה במטמון לפני שהוא מציג אותה. כדי לוודא שהחבילות אוחזרו מהמקור במעלה הזרם למאגר המרוחק, אפשר לצפות ברשימה של החבילות במאגר.
במאגר וירטואלי, מערכת Artifact Registry מחפשת את החבילה המבוקשת במאגרים במעלה הזרם.
- מאגרי מידע מרוחקים במעלה הזרם יורידו את החבילה המבוקשת וישמרו אותה במטמון אם לא קיים עותק במטמון. מאגרים וירטואליים מציגים רק חבילות מבוקשות, ולא מאחסנים אותן.
- אם מבקשים גרסה שזמינה ביותר ממאגר אחד במעלה הזרם, Artifact Registry בוחר מאגר במעלה הזרם לשימוש על סמך הגדרות העדיפות שהוגדרו למאגר הווירטואלי.
לדוגמה, נניח שיש מאגר וירטואלי עם הגדרות העדיפות הבאות למאגרי upstream:
-
main-repo: העדיפות מוגדרת ל-100 secondary-repo1: העדיפות מוגדרת ל-80.secondary-repo2: העדיפות מוגדרת ל-80.test-repo: העדיפות מוגדרת ל-20.
ל-main-repo יש את ערך העדיפות הגבוה ביותר, ולכן המאגר הווירטואלי תמיד מחפש בו קודם.
העדיפות של secondary-repo1 ושל secondary-repo2 מוגדרת כ80. אם חבילה מבוקשת לא זמינה ב-main-repo, Artifact Registry מחפש אותה במאגרים האלה. מכיוון שלשני המאגרים יש אותו ערך עדיפות, אם הגרסה זמינה בשניהם, Artifact Registry יכול לבחור להציג חבילה מכל אחד מהם.
ל-test-repo יש את ערך העדיפות הנמוך ביותר, והוא יציג פריט מאוחסן אם הוא לא נמצא באף אחד ממאגרי המידע האחרים במעלה הזרם.
מחיקת חבילות
מצבי מאגר: רגיל, מרוחק
אתם יכולים למחוק חבילה ואת כל הגרסאות שלה, או למחוק גרסה ספציפית.
- אחרי שמוחקים חבילה, אי אפשר לבטל את הפעולה.
- עבור מאגרי מידע מרוחקים, רק העותק שבמטמון של החבילה נמחק. אין השפעה על מקור הנתונים במעלה הזרם. אם מוחקים חבילה ששמורה במטמון, Artifact Registry יוריד אותה וישמור אותה במטמון שוב בפעם הבאה שהמאגר יקבל בקשה לאותה גרסת חבילה.
אחרי שגרסת חבילה מתפרסמת, אי אפשר לפרסם מחדש חבילה עם אותו שם ושילוב גרסה, גם אחרי שמוחקים את הגרסה. זו הגבלה של npm שמבטיחה שהתוכן של גרסת חבילה שפורסמה תמיד יהיה זהה.
אם רוצים לעודד משתמשים להתקין גרסה מעודכנת של חבילה, אפשר להשתמש בפקודה npm deprecate כדי לסמן את הגרסה הישנה של החבילה כגרסה שהוצאה משימוש. כשמשתמש מנסה להתקין את החבילה שהוצאה משימוש, Artifact Registry מחזיר אזהרה על הוצאה משימוש.
לפני שמוחקים חבילה או גרסת חבילה, חשוב לוודא שטיפלתם בכל התלות החשובה בה.
כדי למחוק חבילה:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
ברשימת המאגרים, לוחצים על המאגר המתאים.
בדף Packages (חבילות) מופיעה רשימת החבילות במאגר.
בוחרים את החבילה שרוצים למחוק.
לוחצים על מחיקה.
בתיבת הדו-שיח לאישור, לוחצים על מחיקה.
gcloud
מריצים את הפקודה הבאה:
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
מחליפים את מה שכתוב בשדות הבאים:
-
PACKAGEהוא שם החבילה במאגר. -
REPOSITORYהוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, תוכלו להשמיט את הדגל הזה כדי להשתמש בברירת המחדל. -
LOCATIONהוא המיקום האזורי או המיקום במספר אזורים של המאגר. אפשר להשתמש בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
הדגל --async גורם לפקודה לחזור באופן מיידי, בלי להמתין שהפעולה תסתיים.
כדי למחוק גרסאות של חבילה:
המסוף
פותחים את הדף Repositories במסוף Google Cloud .
ברשימת המאגרים, לוחצים על המאגר המתאים.
בדף Packages (חבילות) מופיעה רשימת החבילות במאגר.
לוחצים על חבילה כדי לראות את הגרסאות שלה.
בוחרים את הגרסאות שרוצים למחוק.
לוחצים על מחיקה.
בתיבת הדו-שיח לאישור, לוחצים על מחיקה.
gcloud
מריצים את הפקודה הבאה:
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
מחליפים את מה שכתוב בשדות הבאים:
-
VERSIONהוא שם הגרסה שרוצים למחוק. -
PACKAGEהוא שם החבילה במאגר. -
REPOSITORYהוא שם המאגר. אם הגדרתם מאגר ברירת מחדל, תוכלו להשמיט את הדגל הזה כדי להשתמש בברירת המחדל. -
LOCATIONהוא המיקום האזורי או המיקום במספר אזורים של המאגר. אפשר להשתמש בדגל הזה כדי להציג מאגרי מידע במיקום ספציפי. אם הגדרתם מיקום ברירת מחדל, אתם יכולים להשמיט את הדגל הזה כדי להשתמש בברירת המחדל.
הדגל --async גורם לפקודה לחזור באופן מיידי, בלי להמתין שהפעולה תסתיים.