Crea e accedi a un'istanza

Crea e accedi a un'istanza

Crea un'istanza Secure Source Manager e accedi alla sua interfaccia web per prepararti a creare repository e concedere l'accesso agli utenti.

Nota: Secure Source Manager non supporta i progetti dell'ambito del dominio. Se l'ID progetto contiene due punti (:), devi creare un nuovo progetto prima di utilizzare Secure Source Manager.

Prima di iniziare

Accedi al tuo Google Cloud account. 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 senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

Installa Google Cloud CLI.

Nota: se hai già installato gcloud CLI, assicurati di avere l'ultima versione eseguendo gcloud components update.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un Google Cloud progetto:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

• Seleziona il Google Cloud progetto che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

Verifica che la fatturazione sia attivata per il tuo Google Cloud progetto.

Abilita l'API Secure Source Manager:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

gcloud services enable securesourcemanager.googleapis.com

Installa Google Cloud CLI.

Nota: se hai già installato gcloud CLI, assicurati di avere l'ultima versione eseguendo gcloud components update.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un Google Cloud progetto:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

• Seleziona il Google Cloud progetto che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

Verifica che la fatturazione sia attivata per il tuo Google Cloud progetto.

Abilita l'API Secure Source Manager:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

gcloud services enable securesourcemanager.googleapis.com

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un'istanza Secure Source Manager, chiedi all'amministratore di concederti il ruolo IAM Proprietario istanza (roles/securesourcemanager.instanceOwner) nel Google Cloud progetto.

Nota: Il ruolo Amministratore Secure Source Manager (roles/securesourcemanager.admin) o il ruolo di base IAM Proprietario (roles/owner) nel tuo progetto contiene anche le autorizzazioni per creare un'istanza. Non devi concedere ruoli di amministratore o ruoli di base in un ambiente di produzione, ma puoi concederli in un ambiente di sviluppo o test.

I ruoli Secure Source Manager non vengono visualizzati nella Google Cloud console finché non vengono concessi a un'entità. Per concedere un ruolo Secure Source Manager per la prima volta, consulta Concedi e revoca i ruoli IAM.

Crea un'istanza

1. Esegui il comando seguente per creare un'istanza denominata my-instance nella us-central1 località. Ti potrebbe essere chiesto di autenticarti a gcloud CLI.

   gcloud source-manager instances create my-instance \
       --region=us-central1
   

   Dove:

   • my-instance è il nome dell'istanza.
   • us-central1 è la regione in cui stai creando l'istanza.

   Viene avviata un'operazione di creazione dell'istanza a lunga esecuzione. L'output è simile al seguente:

   Create request issued for [my-instance].
   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
     apiVersion: v1
     createTime: '2023-02-27T20:57:52.315609549Z'
     requestedCancellation: false
     target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
     verb: create
   name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
   

   La creazione dell'istanza può richiedere fino a 60 minuti.

2. Prendi nota di OPERATION_NAME, ovvero il nome completo della risorsa dell'operazione ricevuta in risposta alla tua richiesta. Ha il seguente formato ed è obbligatorio quando controlli lo stato dell'operazione nel passaggio successivo:

   projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

   Ad esempio: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e dove PROJECT_ID è il tuo Google Cloud progetto.

3. Controlla lo stato dell'operazione create eseguendo il comando seguente:

   gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

   Sostituisci OPERATION_NAME con il nome dell'operazione restituito nella risposta del comando di creazione.

   Una volta che l'istanza è pronta, la risposta sarà simile alla seguente:

   {
   "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
   "metadata": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
     "createTime": "2022-11-01T14:31:32.420469714Z",
     "endTime": "2022-11-01T14:48:34.140378114Z",
     "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "verb": "create",
     "requestedCancellation": false,
     "apiVersion": "v1"
   },
   "done": true,
   "response": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
     "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "createTime": "2022-11-01T14:31:32.416413630Z",
     "updateTime": "2022-11-01T14:31:32.416413630Z"
     },
     "state": "ACTIVE",
     "hostConfig": {
       "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
       "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
       "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
     }
   }
   }
   

   Dove:

   • my-instance-098765432109.us-central1.sourcemanager.dev è l'URL HTML dell'istanza.
   • PROJECT_ID è l'ID progetto.
   Nota: è possibile che il controllo dello stato indichi il completamento prima che l'istanza sia completamente operativa. Se riscontri errori durante l'accesso all' istanza dopo la creazione, attendi 60 minuti e riprova prima di contattare l'assistenza di Secure Source Manager all' indirizzo [e-mail].

4. Copia l'URL HTML dal comando di controllo dello stato creato correttamente. Avrai bisogno di questo URL per accedere all'istanza utilizzando un browser web.

Accedi a un'istanza

Dopo aver creato l'istanza, puoi accedervi tramite la sua interfaccia web utilizzando un browser.

Nota: per creare repository nell' istanza, devi disporre del ruolo Autore repository (roles/securesourcemanager.repoCreator) nel progetto dell'istanza e del ruolo Autore repository istanza (roles/securesourcemanager.instanceRepositoryCreator) nell'istanza Secure Source Manager.

1. Per ottenere l'URL HTML per l'istanza, esegui di nuovo il comando seguente:

      gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

2. Copia l'URL HTML dalla risposta corretta del comando gcloud source-manager operations describe nella barra degli indirizzi del browser.

3. Viene visualizzata una schermata di OAuth 2.0 che ti chiede se vuoi concedere a sourcemanager.dev l'accesso al tuo Google Cloud account.

4. Fai clic sul pulsante Consenti.

5. Si apre l'interfaccia web di Secure Source Manager. Dall'interfaccia web puoi creare e visualizzare repository e tutti i problemi e le richieste di pull associati.

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il Google Cloud progetto con le risorse.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella Google Cloud console, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Crea e clona un repository
• Concedi agli utenti l'accesso all'istanza
• Aggiungi utenti del repository