Utilizzo del programma di installazione di Google Cloud CLI
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Google Cloud CLI fornisce un programma di installazione per ogni piattaforma supportata e può
essere implementato in modo interattivo o non interattivo.
Installazione interattiva
Il programma di installazione ti consente di scaricare, installare e configurare l'ultima versione di
Google Cloud CLI in modalità interattiva. Quando esegui il programma di installazione,
scarica i componenti di Google Cloud CLI e li installa sul sistema
locale. Esegue anche attività di configurazione aggiuntive, come l'aggiunta di componenti dell'interfaccia a riga di comando gcloud CLI a PATH e l'attivazione del completamento dei comandi nella shell.
Linux e macOS
Nella riga di comando, esegui questo comando:
curlhttps://sdk.cloud.google.com|bash
Quando richiesto, scegli una posizione nel file system (di solito la directory Home) per creare
la sottodirectory google-cloud-sdk.
Se vuoi inviare statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI,
rispondi Y quando ti viene chiesto.
Per aggiungere gli strumenti a riga di comando gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando ti viene richiesto.
Riavvia la shell:
exec-l$SHELL
Per inizializzare l'ambiente Google Cloud CLI, esegui
gcloud init:
gcloudinit
Windows (programma di installazione)
Google Cloud CLI funziona su Windows 8.1 e versioni successive e Windows Server 2012 e versioni successive.
Avvia il programma di installazione e segui le istruzioni nei prompt. Il programma di installazione è firmato da Google LLC.
Se utilizzi uno screen reader, seleziona la casella di controllo Attiva la modalità screen reader. Questa
opzione configura gcloud in modo che utilizzi indicatori di stato anziché spinner Unicode,
mostri l'avanzamento come percentuale e appiattisca le tabelle. Per ulteriori informazioni, consulta la
Guida alle funzionalità di accessibilità.
Google Cloud CLI richiede Python; le versioni supportate sono Python 3.9-3.13. Per
impostazione predefinita, la versione Windows di Google Cloud CLI viene fornita in bundle con Python 3. Per utilizzare
Google Cloud CLI, il sistema operativo deve essere in grado di eseguire una versione supportata di Python.
Il programma di installazione installa tutte le dipendenze necessarie, inclusa la versione di Python richiesta.
Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, puoi utilizzare un'installazione
Python esistente, se necessario, deselezionando l'opzione Installa Python in bundle.
Consulta gcloud topic startup per
scoprire come utilizzare un'installazione di Python esistente.
Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e sul desktop, avviare la shell Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare selezionate le opzioni per avviare la shell e configurare l'installazione. Il programma di installazione avvia una finestra del terminale ed esegue il comando
gcloud init.
L'installazione predefinita non include le estensioni App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud. Questi componenti possono essere installati utilizzando il
gestore di componenti gcloud CLI.
Suggerimenti per la risoluzione dei problemi:
Se l'installazione non va a buon fine
perché il comando find non viene riconosciuto, assicurati che la variabile di ambiente PATH
sia impostata in modo da includere la cartella contenente find. In genere,
si tratta di C:\WINDOWS\system32;.
Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installarla di nuovo.
Se la decompressione non va a buon fine, esegui il programma di installazione come amministratore.
Windows (Zip)
Puoi anche installare l'ultima versione da un file
.zip scaricato:
Scarica google-cloud-sdk.zip ed estraine i contenuti (Fai clic con il tasto destro del mouse sul file scaricato e
seleziona Estrai tutto.)
Avvia lo script google-cloud-sdk\install.bat e segui
le istruzioni di installazione.
Al termine dell'installazione, riavvia il prompt dei comandi
(cmd.exe).
Puoi automatizzare l'installazione di Google Cloud CLI utilizzando lo script di installazione.
Per Linux e macOS:
Salva lo script di installazione localmente anziché inviarlo a bash.
Immetti quanto segue in un prompt dei comandi:
curlhttps://sdk.cloud.google.com > install.sh
Esegui lo script passando gli argomenti descritti di seguito:
bashinstall.sh--disable-prompts
Le opzioni di install.sh sono:
--disable-prompts - disattiva i prompt.
--install-dir=DIRECTORY: imposta la directory principale di installazione su DIRECTORY. Google Cloud CLI è installato in
DIRECTORY/google-cloud-sdk. Il valore predefinito è $HOME.
Per Windows:
/S - installa in modalità invisibile. Non viene visualizzata alcuna pagina del programma di installazione. Utilizza i flag per modificare le impostazioni di installazione.
/D: imposta la directory di installazione predefinita. Deve essere l'ultimo parametro utilizzato nella riga di comando e non deve contenere virgolette, anche se il percorso contiene spazi. Sono supportati solo i percorsi assoluti, ad esempio /D=C:\CloudSDK
/allusers - installazione per tutti gli utenti
/singleuser - installa per l'utente attuale (valore predefinito)
/screenreader - attiva la modalità screen reader (l'impostazione predefinita è la disattivazione)
/reporting - enable usage reporting (default is to turn off usage reporting)
/noreporting - disable usage reporting (default is to turn off usage reporting)
/nostartmenu - don't create start menu shortcut (default is to create
shortcut)
/nodesktop - non creare un collegamento sul desktop (l'impostazione predefinita prevede la creazione di un collegamento)
Provalo
Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[],[],null,["# Using the Google Cloud CLI installer\n\nThe Google Cloud CLI provides an installer for each supported platform and can\nbe deployed interactively or non-interactively.\n\nInteractive installation\n------------------------\n\nThe installer lets you download, install, and set up the latest version of\nGoogle Cloud CLI in an interactive mode. When you run the installer,\nit downloads Google Cloud CLI components and installs them on the local\nsystem. It also performs additional setup tasks like adding gcloud CLI\ncomponents to your `PATH` and enabling command completion in your shell.\n| **Note:** The installer is designed to make it easy for a user to install the latest version of Google Cloud CLI. If you want to use a script to install a specific version in non-interactive mode --- for example, to install the same version automatically every time you build a production system --- use a [versioned archive](/sdk/docs/downloads-versioned-archives) of the Google Cloud CLI.\nLinux and macOS\n\n1. At the command line, run the following command: \n\n ```bash\n curl https://sdk.cloud.google.com | bash\n ```\n2. When prompted, choose a location on your file system (usually your Home directory) to create the `google-cloud-sdk` subdirectory under.\n3. If you want to send anonymous usage statistics to help improve gcloud CLI, answer `Y` when prompted.\n4. To add gcloud CLI command-line tools to your `PATH` and enable command completion, answer `Y` when prompted.\n5. Restart your shell: \n\n ```bash\n exec -l $SHELL\n ```\n6. To initialize the Google Cloud CLI environment, run [`gcloud init`](/sdk/gcloud/reference/init): \n\n ```bash\n gcloud init\n ```\nWindows (Installer)\n\nThe Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.\n1.\n Download the [Google Cloud CLI installer](https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe).\n\n\n Alternatively, open a PowerShell terminal and run the following PowerShell commands: \n\n ```bash\n (New-Object Net.WebClient).DownloadFile(\"https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe\", \"$env:Temp\\GoogleCloudSDKInstaller.exe\")\n\n & $env:Temp\\GoogleCloudSDKInstaller.exe\n \n ```\n2. Launch the installer and follow the prompts. The installer is signed by Google LLC.\n\n\n If you're using a screen reader, check the **Turn on screen reader mode** checkbox. This\n option configures `gcloud` to use status trackers instead of unicode spinners,\n display progress as a percentage, and flatten tables. For more information, see the\n [Accessibility features guide](/sdk/docs/enabling-accessibility-features).\n3. Google Cloud CLI requires Python; supported versions are Python 3.9 to 3.13. By\n default, the Windows version of Google Cloud CLI comes bundled with Python 3. To use\n Google Cloud CLI your operating system must be able to run a supported version of Python.\n\n\n The installer installs all necessary dependencies, including the needed Python version.\n While Google Cloud CLI installs and manages Python 3 by default, you can use an existing\n Python installation if necessary by **unchecking** the option to Install Bundled Python.\n See [`gcloud topic startup`](/sdk/gcloud/reference/topic/startup) to\n learn how to use an existing Python installation.\n4. After installation is complete, the installer gives you the option to create Start Menu\n and Desktop shortcuts, start the Google Cloud CLI shell, and configure the\n gcloud CLI. Make sure that you leave the options to start the shell and configure your\n installation selected. The installer starts a terminal window and runs the\n [`gcloud init`](/sdk/gcloud/reference/init) command.\n\n5. The default installation doesn't include the App Engine extensions required to deploy an application using `gcloud` commands. These components can be installed using the [gcloud CLI component manager](/sdk/docs/managing-components).\n\n**Troubleshooting tips:**\n\n- If your installation is unsuccessful due to the `find` command not being recognized, ensure your `PATH` environment variable is set to include the folder containing `find`. Usually, this is `C:\\WINDOWS\\system32;`.\n- If you uninstalled the gcloud CLI, you must reboot your system before installing the gcloud CLI again.\n- If unzipping fails, run the installer as an administrator.\nWindows (Zip)\n\nYou can also install the latest version from a downloaded\n`.zip` file:\n\n1.\n Download\n [google-cloud-sdk.zip](https://dl.google.com/dl/cloudsdk/channels/rapid/google-cloud-sdk.zip)\n and extract its contents. (Right click on the downloaded file and\n select **Extract All**.)\n\n2.\n Launch the `google-cloud-sdk\\install.bat` script and follow\n the installation prompts.\n\n3.\n When the installation finishes, restart the command prompt\n (`cmd.exe`).\n\n4. Run [`gcloud init`](/sdk/gcloud/reference/init):\n\n ```\n C:\\\u003e gcloud init\n ```\n\nNon-interactive (silent) deployment\n-----------------------------------\n\nYou can automate Google Cloud CLI installation using the install script.\n\n**For Linux and MacOS:**\n\nSave the install script locally instead of piping it to bash.\n\n1. Enter the following at a command prompt: \n\n ```bash\n curl https://sdk.cloud.google.com \u003e install.sh\n ```\n2. Run the script, passing arguments described as follows: \n\n ```bash\n bash install.sh --disable-prompts\n ```\n\nThe `install.sh` options are:\n\n- `--disable-prompts` - disable prompts.\n- `--install-dir=`\u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e - set the installation root directory to \u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e. The Google Cloud CLI is installed in \u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e`/google-cloud-sdk`. The default is $HOME.\n\n**For Windows:**\n| **Important:** These flags are for the [Windows installer](/sdk/docs/install-sdk) and are case sensitive.\n\n- `/S` - install silently. No installer pages are displayed. Use flags to change install settings.\n- `/D` - set the default installation directory. It must be the last parameter used in the command line and must not contain any quotes, even if the path contains spaces. Only absolute paths are supported, for example `/D=C:\\CloudSDK`\n- `/allusers` - install for all users\n- `/singleuser` - install for current user (default)\n- `/screenreader` - turn on screen reader mode (default is to turn it off)\n- `/reporting` - enable usage reporting (default is to turn off usage reporting)\n- `/noreporting` - disable usage reporting (default is to turn off usage reporting)\n- `/nostartmenu` - don't create start menu shortcut (default is to create shortcut)\n- `/nodesktop` - don't create desktop shortcut (default is to create shortcut)\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how our\nproducts perform in real-world scenarios. New customers also get $300 in\nfree credits to run, test, and deploy workloads.\n[Get started for free](https://console.cloud.google.com/freetrial)"]]
