Configura policy di pulizia

Le policy di pulizia di Artifact Registry ti consentono di automatizzare la conservazione e la rimozione degli artefatti nei tuoi repository. Questi processi possono aiutarti a ridurre i costi di archiviazione degli artefatti. Le policy possono contenere regole di "eliminazione" e "conservazione" basate su stato, prefissi o età dei tag. Puoi visualizzare l'anteprima delle modifiche con un dry run prima di applicarle.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per applicare o rimuovere le policy di pulizia, chiedi all'amministratore di concederti il ruolo IAM Artifact Registry Administrator (roles/artifactregistry.admin) nel progetto del repository. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per applicare o rimuovere le policy di pulizia. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per applicare o rimuovere le policy di pulizia sono necessarie le seguenti autorizzazioni:

  • artifactregistry.repositories.update
  • Per eliminare gli artefatti che soddisfano i criteri di una policy di pulizia: artifactregistry.versions.delete

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Il ruolo predefinito per l'agente di servizio Artifact Registry include l'autorizzazione artifactregistry.versions.delete, necessaria per eliminare le immagini che soddisfano i criteri di una policy di pulizia.

Creare un file di criteri

Un file di policy è un file JSON che definisce le policy di eliminazione e conservazione. Puoi creare un file della policy creando e modificando un file JSON, quindi utilizzando Google Cloud CLI per applicare la policy o utilizzando la console Google Cloud . Le policy di eliminazione specificano le condizioni per l'eliminazione degli artefatti. Le policy di conservazione specificano le condizioni per conservare un artefatto o un numero di versioni recenti da conservare. Non puoi utilizzare condizioni e versioni più recenti nella stessa policy di conservazione.

Crea una politica di cancellazione

Una politica di cancellazione consente di specificare l'età minima o massima per l'eliminazione degli artefatti e criteri di filtro aggiuntivi per limitare la policy ad artefatti specifici.

Se hai determinati artefatti che non vuoi eliminare per nessun motivo, crea una policy di conservazione condizionale o una policy di conservazione delle versioni più recenti, oltre a una politica di cancellazione. Se un artefatto corrisponde ai criteri sia della politica di cancellazione sia della policy di conservazione, l'artefatto viene conservato.

console

Puoi creare una politica di cancellazione per un repository nuovo o esistente.

Per aggiungere una politica di cancellazione a un repository esistente:

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, seleziona Dry run per testare la nuova policy prima di eseguire l'eliminazione degli artefatti. Per saperne di più sui risultati del test, consulta dry run.

    Quando hai la certezza che la policy funzioni come previsto, modifica di nuovo le impostazioni del repository e seleziona Elimina artefatti per applicare la policy di pulizia ed eliminare gli artefatti selezionati.

  4. Fai clic su Aggiungi una policy di pulizia e aggiungi quanto segue:

    • Nome: assegna un nome alla policy di pulizia. Il nome deve essere univoco all'interno del gruppo di policy che applichi a un repository.
    • Tipo di policy: seleziona Eliminazione condizionale.
    • Stato del tag: indica se la policy deve verificare la presenza di artefatti con o senza tag. Gli artefatti vengono taggati quando viene eseguito il push o il pull di un'immagine da o verso un repository. Per saperne di più sui tag Docker, consulta Concetti relativi ai container.

      • Qualsiasi stato del tag: ignora lo stato del tag e si applica sia agli artefatti con tag che a quelli senza tag.
      • Con tag: si applica solo agli artefatti con tag.
      • Senza tag: si applica solo agli artefatti senza tag.

      I formati che non supportano i tag vengono trattati come untagged. Se in un repository sono abilitati i tag immutabili, gli artefatti con tag non possono essere eliminati.

      Per saperne di più sullo stato dei tag applicato alle policy di pulizia, consulta il riferimento a TagState.

  5. Di seguito sono riportati i modi facoltativi per definire la politica di cancellazione:

    • Prefissi tag: un elenco separato da virgole di prefissi tag. Ad esempio, i prefissi test e staging corrispondono alle immagini con i tag testenv e staging-1.5. tagState deve essere impostato su TAGGED per utilizzare i prefissi dei tag.
    • Prefissi versione: un elenco separato da virgole di prefissi delle versioni degli artefatti. Ad esempio, v1, v2 corrisponderebbe alle versioni v1.5, v2.0alpha e v10.2.
    • Prefissi pacchetto: un elenco di prefissi dei nomi degli artefatti. Puoi inserire più prefissi premendo Enter o , tra i prefissi. Ad esempio, red, blue creerebbe due prefissi, red e blue, e corrisponderebbe ai nomi degli artefatti red-team, redis e bluebird.
    • Older than: è il tempo minimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni. Puoi specificare durate di secondi, minuti, ore o giorni aggiungendo rispettivamente s, m, h o d.
    • Più recente di: il tempo massimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni.
  6. Puoi aggiungere altre policy di pulizia facendo clic su Aggiungi una policy di pulizia.

  7. Fai clic su Aggiorna.

    La policy di pulizia viene applicata al repository. Puoi visualizzare le policy di pulizia nella sezione Dettagli repository facendo clic su Mostra altro.

JSON

{
  "name": "DELETE_POLICY_NAME",
  "action": {"type": "Delete"},
  "condition": {
    "tagState": "TAG_STATUS",
    "tagPrefixes": ["TAG_PREFIXES"],
    "versionNamePrefixes": ["VERSION_PREFIXES"],
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "olderThan": "OLDER_THAN_DURATION",
    "newerThan": "NEWER_THAN_DURATION"
  }
}

Una politica di cancellazione deve includere un nome, un'azione e almeno una condizione.

name
Nello snippet della politica di cancellazione, DELETE_POLICY_NAME è il nome della policy. Il nome deve essere univoco all'interno del gruppo di policy che applichi a un repository.
action
Per una politica di cancellazione, il valore è {"type": "Delete"}.
condition
Specifica una o più delle seguenti condizioni:
  • tagState: TAG_STATUS indica se la policy deve verificare la presenza di artefatti con o senza tag. Gli artefatti vengono taggati quando viene eseguito il push o il pull di un'immagine da o verso un repository. I valori supportati sono:

    • tagged: si applica solo agli artefatti taggati.
    • untagged: si applica solo agli artefatti senza tag.
    • any: ignora lo stato dei tag e si applica sia agli artefatti con tag sia a quelli senza tag.

    I formati che non supportano i tag vengono trattati come untagged. Se un repository ha i tag immutabili abilitati, gli artefatti con tag non possono essere eliminati.

    Per saperne di più sui tag Docker, consulta Concetti relativi ai container.

  • tagPrefixes: TAG_PREFIXES è un elenco separato da virgole di prefissi dei tag. Ad esempio, "test", "staging" corrisponde alle immagini con i tag "testenv" e "staging-1.5". tagState deve essere impostato su TAGGED per utilizzare i prefissi dei tag.

  • versionNamePrefixes: VERSION_PREFIXES è un elenco separato da virgole di prefissi delle versioni degli artefatti. Ad esempio, "v1", "v2" corrisponderà alle versioni "v1.5", "v2.0alpha" e "v10.2".

  • packageNamePrefixes: PACKAGE_PREFIXES è un elenco separato da virgole di prefissi dei nomi degli artefatti. Ad esempio, "red", "blue" corrisponde ai nomi degli artefatti "red-team", "redis" e "bluebird".

  • olderThan: OLDER_THAN_DURATION è il tempo minimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni. Puoi specificare durate di secondi, minuti, ore o giorni aggiungendo rispettivamente s, m, h o d.

  • newerThan: NEWER_THAN_DURATION è il tempo massimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni.

Artifact Registry esegue dry run e run attivi delle policy di pulizia utilizzando un job in background che viene eseguito periodicamente. Le modifiche diventano effettive entro un giorno circa.

Crea una policy di conservazione condizionale

Una policy di conservazione condizionale specifica i criteri per la conservazione degli artefatti. Le policy di conservazione funzionano insieme alle politiche di cancellazione per conservare gli artefatti che verrebbero eliminati in base alle specifiche della politica di cancellazione, ma che vuoi conservare. Quando un artefatto corrisponde ai criteri sia di una politica di cancellazione sia di una policy di conservazione, l'artefatto viene conservato.

console

Puoi creare una policy di conservazione per un repository nuovo o esistente.

Per aggiungere una policy di conservazione a un repository esistente:

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, seleziona Dry run per testare la nuova policy prima di eseguire l'eliminazione degli artefatti. Devi impostare almeno una politica di cancellazione per visualizzare i risultati della policy di conservazione. Per saperne di più su come visualizzare i risultati del test, consulta dry run.

    Quando hai la certezza che le policy funzionino come previsto, modifica di nuovo le impostazioni del repository e seleziona Elimina artefatti per applicare le policy di pulizia ed eliminare gli artefatti selezionati.

  4. Fai clic su Aggiungi una policy di pulizia e aggiungi quanto segue:

    • Nome: assegna un nome alla policy di pulizia. Il nome deve essere univoco all'interno del gruppo di policy che applichi a un repository.
    • Tipo di policy: seleziona Conservazione condizionale.
    • Stato del tag: indica se la policy deve verificare la presenza di artefatti con o senza tag. Gli artefatti vengono taggati quando viene eseguito il push o il pull di un'immagine da o verso un repository. Per saperne di più sui tag Docker, consulta Concetti relativi ai container.

      • Qualsiasi stato del tag: ignora lo stato del tag e si applica sia agli artefatti con tag che a quelli senza tag.
      • Con tag: si applica solo agli artefatti con tag.
      • Senza tag: si applica solo agli artefatti senza tag.

      I formati che non supportano i tag vengono trattati come untagged. Se in un repository sono abilitati i tag immutabili, gli artefatti con tag non possono essere eliminati. Per saperne di più sullo stato dei tag applicato alle policy di pulizia, consulta il riferimento a TagState.

  5. Di seguito sono riportati i modi facoltativi per definire la policy di conservazione:

    • Prefissi tag: un elenco separato da virgole di prefissi tag. Ad esempio, i prefissi test e staging corrispondono alle immagini con i tag testenv e staging-1.5. tagState deve essere impostato su TAGGED per utilizzare i prefissi dei tag.
    • Prefissi versione: un elenco separato da virgole di prefissi delle versioni degli artefatti. Ad esempio, v1, v2 corrisponderebbe alle versioni v1.5, v2.0alpha e v10.2.
    • Prefissi dei pacchetti: un elenco separato da virgole di prefissi dei nomi degli artefatti. Ad esempio, red, blue corrisponde ai nomi degli artefatti red-team, redis e bluebird.
    • Older than: è il tempo minimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni. Puoi specificare durate di secondi, minuti, ore o giorni aggiungendo rispettivamente s, m, h o d.
    • Più recente di: il tempo massimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni.
  6. Puoi aggiungere altre policy di pulizia facendo clic su Aggiungi una policy di pulizia.

  7. Fai clic su Aggiorna.

    La policy di pulizia viene applicata al repository.

JSON

Il formato è simile a una politica di cancellazione. Per una policy di conservazione, il valore di action è {"type": "Keep"}.

{
  "name": "KEEP_POLICY_NAME",
  "action": {"type": "Keep"},
  "condition": {
    "tagState": "TAG_STATUS",
    "tagPrefixes": ["TAG_PREFIXES"],
    "versionNamePrefixes": ["VERSION_PREFIXES"],
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "olderThan": "OLDER_THAN_DURATION",
    "newerThan": "NEWER_THAN_DURATION"
  }
}

Sostituisci quanto segue:

  • KEEP_POLICY_NAME con il nome della policy di pulizia. Il nome deve essere univoco all'interno del gruppo di policy che applichi a un repository.
  • TAG_STATUS con lo stato del tag, che indica se la policy deve verificare la presenza di artefatti con o senza tag. Gli artefatti vengono taggati quando viene eseguito il push o il pull di un'immagine da o verso un repository. Per saperne di più sui tag Docker, consulta Concetti relativi ai container.

    Le opzioni sono:

    • tagged: si applica solo agli artefatti taggati.
    • untagged: si applica solo agli artefatti senza tag.
    • any: si applica a tutte le versioni

    I formati che non supportano i tag vengono trattati come untagged. Se in un repository sono abilitati i tag immutabili, gli artefatti con tag non possono essere eliminati. Per saperne di più sullo stato dei tag applicato alle policy di pulizia, consulta il riferimento a TagState.

  • TAG_PREFIXES con un elenco separato da virgole di prefissi dei tag. Ad esempio, i prefissi test e staging corrispondono alle immagini con i tag testenv e staging-1.5. tagState deve essere impostato su TAGGED per utilizzare i prefissi dei tag.

  • VERSION_PREFIXES con un elenco separato da virgole di prefissi delle versioni degli artefatti. Ad esempio, v1, v2 corrisponde alle versioni v1.5, v2.0alpha e v10.2.

  • PACKAGE_PREFIXES con un elenco separato da virgole di prefissi dei nomi degli artefatti. Ad esempio, red, blue corrisponde ai nomi degli artefatti red-team, redis e bluebird.

  • OLDER_THAN_DURATION con il tempo minimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni. Puoi specificare durate di secondi, minuti, ore o giorni aggiungendo rispettivamente s, m, h o d.
  • NEWER_THAN_DURATION con il tempo massimo trascorso dalla creazione della versione di un artefatto nel repository, specificato come durata. Ad esempio, 30d corrisponde a 30 giorni.

Artifact Registry esegue dry run e run attivi delle policy di pulizia utilizzando un job in background che viene eseguito periodicamente. Le modifiche diventano effettive entro un giorno circa.

Crea una policy di conservazione per le versioni più recenti

Puoi creare una policy di conservazione per conservare un numero specifico di versioni. Non puoi utilizzare i criteri Conservazione condizionale e Conserva le versioni più recenti nella stessa policy di conservazione.

Le policy di conservazione funzionano con le politiche di cancellazione per conservare gli artefatti che verrebbero eliminati in base alle specifiche della politica di cancellazione, ma che vuoi conservare. Quando un artefatto corrisponde ai criteri sia di una politica di cancellazione sia di una policy di conservazione, l'artefatto viene conservato.

console

Puoi creare una policy per conservare le versioni più recenti per un repository nuovo o esistente.

Per aggiungere una policy per conservare le versioni più recenti a un repository esistente:

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, seleziona Dry run per testare la nuova policy prima di eseguire l'eliminazione degli artefatti. Devi impostare almeno una politica di cancellazione per visualizzare i risultati della policy di conservazione. Per saperne di più su come visualizzare i risultati del test, consulta dry run.

    Quando hai la certezza che le policy funzionino come previsto, modifica di nuovo le impostazioni del repository e seleziona Elimina artefatti per applicare le policy di pulizia ed eliminare gli artefatti selezionati.

  4. Fai clic su Aggiungi una policy di pulizia e aggiungi quanto segue:

    • Nome: assegna un nome alla policy di pulizia. Il nome deve essere univoco all'interno del gruppo di policy che applichi a un repository.
    • Tipo di policy: seleziona Conserva le versioni più recenti.
  5. Nel campo Mantieni conteggio, inserisci il numero di versioni di un artefatto da conservare nel repository.

  6. (Facoltativo) Seleziona Prefissi dei pacchetti per specificare i prefissi dei pacchetti a cui applicare la policy di conservazione. Ad esempio, red, blue corrisponde ai nomi degli artefatti red-team, redis e bluebird.

  7. Puoi aggiungere altre policy di pulizia facendo clic su Aggiungi una policy di pulizia.

  8. Fai clic su Aggiorna.

    La policy di pulizia viene applicata al repository. Puoi visualizzare le policy di pulizia nella sezione Dettagli repository facendo clic su Mostra altro.

JSON

Il formato è simile a una politica di cancellazione. Per una policy di conservazione, il valore di action è {"type": "Keep"}.

Una policy di conservazione per conservare un numero specifico di versioni ha una sezione mostRecentVersions anziché una sezione condition.

{
  "name": "KEEP_POLICY_NAME",
  "action": {"type": "Keep"},
  "mostRecentVersions": {
    "packageNamePrefixes": ["PACKAGE_PREFIXES"],
    "keepCount": MINIMUM_NUMBER
  }
}

Sostituisci quanto segue:

  • KEEP_POLICY_NAME con un nome per la policy di conservazione. Il nome deve essere univoco all'interno del gruppo di policy che applichi a un repository.
  • PACKAGE_PREFIXES con i prefissi dei pacchetti facoltativi a cui applicare la policy di conservazione. Ad esempio, red, blue corrisponde ai nomi degli artefatti red-team, redis e bluebird.
  • MINIMUM_NUMBER con il numero di versioni di un artefatto da conservare nel repository.

Per applicare la policy di conservazione a tutti i pacchetti nel repository, ometti la condizione packageNamePrefixes. Viene conservato il numero specificato di versioni recenti di ogni pacchetto nel repository.

Artifact Registry esegue dry run e run attivi delle policy di pulizia utilizzando un job in background che viene eseguito periodicamente. Le modifiche diventano effettive entro un giorno circa.

Esempio di file della policy

Il seguente esempio di file delle policy contiene una politica di cancellazione e due policy di conservazione.

  • La policy delete-prerelease rimuove le versioni degli artefatti 30 giorni dopo il caricamento se l'artefatto inizia con la stringa alpha o v0.
  • La policy keep-tagged-release conserva gli artefatti con tag con il prefisso release che hanno un nome file che inizia con webapp o mobile.
  • La policy keep-minimum-versions conserva le cinque versioni più recenti degli artefatti con un nome file che inizia con webapp, mobile o sandbox.
[
  {
    "name": "delete-prerelease",
    "action": {"type": "Delete"},
    "condition": {
      "tagState": "tagged",
      "tagPrefixes": ["alpha", "v0"],
      "olderThan": "30d"
    }
  },
  {
    "name": "keep-tagged-release",
    "action": {"type": "Keep"},
    "condition": {
      "tagState": "tagged",
      "tagPrefixes": ["release"],
      "packageNamePrefixes": ["webapp", "mobile"]
    }
  },
  {
    "name": "keep-minimum-versions",
    "action": {"type": "Keep"},
    "mostRecentVersions": {
      "packageNamePrefixes": ["webapp", "mobile", "sandbox"],
      "keepCount": 5
    }
  }
]

Testa le policy con un dry run

Per testare le policy di pulizia, puoi impostarle su dry run nella console o eseguire il comando gcloud artifacts set-cleanup-policies con il flag --dry-run.

Per analizzare l'effetto delle policy di pulizia, puoi visualizzare gli audit log di accesso ai dati di Artifact Registry. Per ricevere gli audit log di controllo dell'accesso ai dati per le policy di pulizia, devi abilitare esplicitamente il tipo di audit log di accesso ai dati Scrittura dati per il servizio Artifact Registry. Per abilitare i log di controllo dell'accesso ai dati, consulta Abilita i log di controllo.

console

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, seleziona Dry run.

  4. Fai clic su Aggiungi una policy di pulizia e configura le opzioni per le policy Eliminazione condizionale, Conservazione condizionale o Conserva le versioni più recenti.

  5. Fai clic su Aggiorna.

Quando una politica di cancellazione genera un'azione BatchDeleteVersions, il parametro validateOnly restituisce "true".

Artifact Registry esegue dry run e run attivi delle policy di pulizia utilizzando un job in background che viene eseguito periodicamente. Le modifiche diventano effettive entro un giorno circa.

Attendi almeno un giorno prima di eseguire query sugli audit log per il dry run.

Per eseguire query sugli audit log per i dry run delle policy di pulizia, esegui il seguente comando:

gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY/packages/-" AND protoPayload.request.validateOnly=true' \
    --resource-names="projects/PROJECT_ID" \
    --project=PROJECT_ID

L'output è simile al seguente:

insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
  first: true
  id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
  producer: artifactregistry.googleapis.com
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
  authorizationInfo:
  - granted: true
    permission: artifactregistry.versions.delete
    resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    resourceAttributes: {}
  methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
  request:
    '@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
    names:
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    validateOnly: true
  requestMetadata:
    callerIp: private
    callerSuppliedUserAgent: stubby_client
    destinationAttributes: {}
    requestAttributes:
      auth: {}
      time: '2023-05-26T04:31:21.909465579Z'
  resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
  serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
  labels:
    method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
    project_id: my-project
    service: artifactregistry.googleapis.com
  type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'

gcloud

Per eseguire un dry run con le policy di pulizia, esegui questo comando:

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --dry-run

Sostituisci quanto segue:

  • REPOSITORY con il nome del repository.
  • PROJECT_ID: l'ID del tuo progetto Google Cloud .
  • LOCATION è la località regionale o multiregionale del repository.

Quando una politica di cancellazione genera un'azione BatchDeleteVersions, il parametro validateOnly restituisce "true".

Artifact Registry esegue dry run e run attivi delle policy di pulizia utilizzando un job in background che viene eseguito periodicamente. Le modifiche diventano effettive entro un giorno circa.

Attendi almeno un giorno prima di eseguire query sugli audit log per il dry run.

Per eseguire query sugli audit log per i dry run delle policy di pulizia, esegui il seguente comando:

gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY/packages/-" AND protoPayload.request.validateOnly=true' \
    --resource-names="projects/PROJECT_ID" \
    --project=PROJECT_ID

L'output è simile al seguente:

insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
  first: true
  id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
  producer: artifactregistry.googleapis.com
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
  authorizationInfo:
  - granted: true
    permission: artifactregistry.versions.delete
    resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    resourceAttributes: {}
  methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
  request:
    '@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
    names:
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
    - projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
    validateOnly: true
  requestMetadata:
    callerIp: private
    callerSuppliedUserAgent: stubby_client
    destinationAttributes: {}
    requestAttributes:
      auth: {}
      time: '2023-05-26T04:31:21.909465579Z'
  resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
  serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
  labels:
    method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
    project_id: my-project
    service: artifactregistry.googleapis.com
  type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'

Applica le policy a un repository

Per utilizzare le policy di pulizia definite in un file JSON locale, applicale ai repository in cui vuoi che Artifact Registry gestisca l'eliminazione automatica delle versioni degli artefatti utilizzando gcloud CLI.

Per applicare le policy di pulizia impostate su Dry run nella console, imposta la policy su Elimina artefatti.

Puoi applicare le policy di pulizia solo ai repository standard. Non puoi applicare policy di pulizia a:

  • Un progetto Google Cloud .

console

Per applicare le policy di pulizia:

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, seleziona Elimina artefatti.

    Artifact Registry elimina e conserva gli artefatti che corrispondono alle tue policy utilizzando un job in background eseguito periodicamente. Le modifiche dovrebbero diventare effettive entro circa un giorno.

gcloud

Per applicare le policy di pulizia, esegui questo comando nella directory con il file delle policy di pulizia.

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --no-dry-run

Sostituisci quanto segue:

  • REPOSITORY con il nome del repository.
  • PROJECT_ID: l'ID del tuo progetto Google Cloud .
  • LOCATION è la località regionale o multiregionale del repository.
  • POLICY_FILE è il nome del file con la policy di pulizia.

Il flag --no-dry-run disattiva la funzionalità di dry run per il repository.

Ad esempio, il comando seguente applica le policy in policy.json al repository my-repo nella regione us-west1 nel progetto my-project.

gcloud artifacts repositories set-cleanup-policies my-repo \
    --project=my-project \
    --location=us-west1 \
    --policy=policy.json

Artifact Registry elimina e conserva gli artefatti che corrispondono alle tue policy utilizzando un job in background eseguito periodicamente. Le modifiche dovrebbero essere applicate entro circa un giorno.

Aggiornamento di un criterio

console

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, fai clic sul nome della policy che vuoi modificare.

  4. Modifica la policy di pulizia e fai clic su Aggiorna.

    La policy di pulizia viene applicata al repository.

gcloud

Per aggiornare le policy esistenti, modifica le impostazioni nel file delle policy, quindi esegui il comando seguente per applicare nuovamente le policy.

gcloud artifacts repositories set-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --policy=POLICY_FILE \
    --no-dry-run

Sostituisci quanto segue:

  • REPOSITORY con il nome del repository.
  • PROJECT_ID: l'ID del tuo progetto Google Cloud .
  • LOCATION è la località regionale o multiregionale del repository.
  • POLICY_FILE è il nome del file con la policy di pulizia.

Il flag --no-dry-run disattiva la funzionalità di dry run per il repository.

Elenca le policy di pulizia del repository

Puoi visualizzare le policy di pulizia associate a un repository.

console

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona quello che vuoi visualizzare.

  3. Nella sezione Dettagli repository, fai clic su Mostra altro.

    Vengono visualizzati i nomi delle policy di pulizia.

  4. Per visualizzare o modificare i dettagli delle policy di pulizia del repository, fai clic su Modifica repository.

    I dettagli delle policy di pulizia esistenti sono elencati nella sezione Policy di pulizia.

gcloud

Esegui questo comando:

gcloud artifacts repositories list-cleanup-policies REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION

Sostituisci quanto segue:

  • REPOSITORY con il nome del repository.
  • PROJECT_ID: l'ID del tuo progetto Google Cloud .
  • LOCATION è la località regionale o multiregionale del repository.

Rimuovi una policy da un repository

Rimuovi una policy di pulizia da un repository quando non vuoi più che Artifact Registry elimini automaticamente le versioni degli artefatti.

console

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Nella sezione Policy di pulizia, passa il mouse sopra il nome della policy che vuoi eliminare.

  4. Fai clic sull'icona Elimina.

  5. Fai clic su Aggiorna.

    La policy di pulizia viene eliminata.

gcloud

Esegui questo comando:

gcloud artifacts repositories delete-cleanup-policies REPOSITORY \
    --policynames=POLICY_NAMES \
    --project=PROJECT_ID \
    --location=LOCATION

Sostituisci quanto segue:

  • REPOSITORY è il nome del repository.
  • PROJECT_IDè l'ID del tuo progetto Google Cloud .
  • LOCATION è la località regionale o multiregionale del repository.
  • POLICY_NAMES è un elenco separato da virgole dei nomi delle policy che vuoi rimuovere.

Ad esempio, il seguente comando rimuove una policy denominata delete-test dal repository my-repo nella regione us-west1 nel progetto my-project:

gcloud artifacts repositories delete-cleanup-policies my-repo \
    --policynames=delete-test \
    --project=my-project \
    --location=us-west1

Voci di log di controllo per le policy di pulizia

Per visualizzare le voci di log delle policy di pulizia in Cloud Logging, devi abilitare il logging di DATA_WRITE.

Quando imposti una policy di pulizia su un repository, l'operazione viene registrata come aggiornamento del repository (operazione UpdateRepository).

Quando Artifact Registry elimina una versione di un artefatto, registra l'evento nei log di accesso ai dati di Cloud Logging. Le voci di log mostrano che l'eliminazione è stata eseguita dal account di servizio Artifact Registry. L'ID account di servizio Artifact Registry ha il formato service-PROJECT-NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com