Cómo trabajar con otros formatos de artefactos

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

Ejecuta el siguiente comando:

gcloud artifacts generic upload \
    --project=PROJECT \
    --source=SOURCE \
    --package=PACKAGE \
    --version=VERSION \
    --location=LOCATION \
    --repository=REPOSITORY

gcloud artifacts generic upload `
    --project=PROJECT `
    --source=SOURCE `
    --package=PACKAGE `
    --version=VERSION `
    --location=LOCATION `
    --repository=REPOSITORY

gcloud artifacts generic upload ^
    --project=PROJECT ^
    --source=SOURCE ^
    --package=PACKAGE ^
    --version=VERSION ^
    --location=LOCATION ^
    --repository=REPOSITORY

• --destination-path=PATH para subir a una carpeta especificada dentro del paquete y la versión. También creará las carpetas que no existan.
• --source-directory=SOURCE_DIR para reemplazar la marca --source y subir un directorio en lugar de un solo archivo
• --skip-existing cuando se usa la marca --source-directory para omitir archivos que ya existen. De lo contrario, el comando fallará cuando intente subir un archivo que ya existe.

API

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT es tu Google Cloud ID del proyecto. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
• LOCATION es la ubicación regional o multirregional del repositorio.
• REPOSITORY es el nombre del repositorio en el que se almacena el artefacto.
• SOURCE es la ubicación y el nombre del archivo que subes.
• PACKAGE es el nombre del paquete del archivo que subes.
• VERSION es la versión del archivo que subirás.
• NAME es el nombre nuevo del archivo en el repositorio.

Método HTTP y URL:

  POST https://artifactregistry.googleapis.com/upload/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/genericArtifacts:create?alt=json

curl (Linux, macOS o Cloud Shell)

Para enviar tu solicitud, ejecuta el siguiente comando:

  curl -v \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -F "meta={'filename':'NAME','package_id':'PACKAGE','version_id':'VERSION'};type=application/json" \
      -F "blob=@SOURCE" \
      https://artifactregistry.googleapis.com/upload/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSTIORY/genericArtifacts:create?alt=json

Console

Puedes ver los artefactos de los repositorios de formato genérico en la consola deGoogle Cloud .

1. Abre la página Repositorios en la consola de Google Cloud .

   Open the Repositories page

2. En la lista de repositorios, selecciona el repositorio.

3. Haz clic en el nombre del paquete.

4. Para ver los archivos descargables de todas las versiones del paquete, haz clic en la pestaña Files.

5. Para ver los archivos descargables de una versión específica de tu paquete, haz clic en el nombre de la versión y, luego, en la pestaña Files.

gcloud

Puedes enumerar los artefactos en un repositorio con el comando gcloud artifacts files list.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

• PROJECT: Tu Google Cloud ID del proyecto. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
• LOCATION: Es la ubicación regional o multirregional del repositorio.
• REPOSITORY: Es el nombre del repositorio en el que se almacena el artefacto.

Ejecuta el siguiente comando:

gcloud artifacts files list \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY

gcloud artifacts files list `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY

gcloud artifacts files list ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

También es posible ordenar por versión y paquete agregando una o ambas de las siguientes marcas:

• --package=PACKAGE para mostrar solo los archivos de un paquete específico
• --version=VERSION para mostrar solo los archivos de una versión específica.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

• DESTINATION: Es la ruta de acceso a la carpeta de destino en tu sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
• LOCATION: Es la ubicación regional o multirregional del repositorio.
• REPOSITORY: Es el nombre del repositorio en el que se almacena el artefacto.
• PACKAGE: Es el paquete del archivo que se descargará.
• VERSION: Es la versión del archivo que se descargará.
• NAME (opcional): Es el nombre del archivo que se descargará. Sin esta marca, el comando descargará todos los archivos del paquete y la versión especificados, y creará los directorios necesarios en el destino.

Ejecuta el siguiente comando:

gcloud artifacts generic download \
    --destination=DESTINATION \
    --location=LOCATION \
    --repository=REPOSITORY \
    --package=PACKAGE \
    --version=VERSION \
    --name=NAME

gcloud artifacts generic download `
    --destination=DESTINATION `
    --location=LOCATION `
    --repository=REPOSITORY `
    --package=PACKAGE `
    --version=VERSION `
    --name=NAME

gcloud artifacts generic download ^
    --destination=DESTINATION ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --package=PACKAGE ^
    --version=VERSION ^
    --name=NAME

API

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT: Tu Google Cloud ID del proyecto. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
• LOCATION: Es la ubicación regional o multirregional del repositorio.
• REPOSITORY: Es el nombre del repositorio en el que se almacena el artefacto.
• DESTINATION: Es la ruta de acceso a la carpeta de destino en tu sistema de archivos local. La carpeta de destino ya debe existir o el comando fallará.
• FILE: Es el nombre de archivo codificado en URL. Puedes encontrar este valor ejecutando el comando gcloud artifacts files list y copiando el valor de FILE. Se debe convertir al formato codificado como URL para este comando. Por ejemplo, path/to/file.jar se debe ingresar como path%2Fto%2Ffile.jar.

Método HTTP y URL:

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

Para enviar tu solicitud, expande una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"