Crea e accedi a un'istanza

Crea e accedi a un'istanza

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

Nota: Secure Source Manager non supporta i progetti con ambito a livello di 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 account Google Cloud . 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 per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. 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.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

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

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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

Abilita l'API Secure Source Manager:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. 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 per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. 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.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

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

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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

Abilita l'API Secure Source Manager:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

gcloud services enable securesourcemanager.googleapis.com

Ruoli obbligatori

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

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

I ruoli di Secure Source Manager non vengono visualizzati nella console Google Cloud finché non sono stati 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 questo comando per creare un'istanza denominata my-instance nella us-central1 posizione. Potrebbe esserti chiesto di autenticarti in 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 per controllare 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 questo comando:

   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.

   Quando 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 segnali 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 stato del controllo creato correttamente. Avrai bisogno di questo URL per accedere all'istanza utilizzando un browser web.

Accedere 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 Repo Creator (roles/securesourcemanager.repoCreator) nel progetto dell'istanza e del ruolo Instance Repository Creator (roles/securesourcemanager.instanceRepositoryCreator) nell'istanza Secure Source Manager.

1. Per ottenere l'URL HTML per la tua istanza, esegui di nuovo questo comando:

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

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

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

4. Fai clic sul pulsante Consenti.

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

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud 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 console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona quello 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
• Concedere agli utenti l'accesso all'istanza
• Aggiungere utenti al repository