Usa Boto

En esta página, se describe cómo gsutil usa un archivo de configuración boto y proporciona un ejemplo de colaboración boto.

Usa boto con Cloud Storage

  • Cuando gsutil se instaló como parte del SDK de Google Cloud:

    Recomendamos que instales gsutil como parte del SDK de Google Cloud. Cuando lo haces, el archivo de configuración de boto o gsutil contiene valores que controlan cómo se comporta gsutil, por ejemplo, qué API prefiere usar gsutil (con la variable prefer_api). Estas variables se pueden cambiar si editas el archivo directamente. El archivo no contiene credenciales y no controla el ID del proyecto predeterminado, debido a que los controla el SDK de Cloud.

  • Cuando gsutil se instaló como una herramienta independiente:

    Cuando gsutil se instaló como una herramienta independiente, el archivo de configuración boto o gsutil contiene valores que controlan cómo se comporta gsutil, por ejemplo, qué API y qué ID del proyecto predeterminado prefiere usar gsutil (con las variables prefer_api y default_project_id, respectivamente). Estas variables se pueden cambiar si editas el archivo directamente. El archivo también controla las credenciales y la configuración de OAuth2, que sueles crear con el comando gsutil config.

La ubicación predeterminada del archivo de configuración boto está en el directorio de inicio del usuario, ~/.boto, para Linux y macOS, y en %HOMEDRIVE%%HOMEPATH%, para Windows. Puedes obtener la ubicación del archivo de configuración si ejecutas el comando gsutil version -l.

Puedes anular la ubicación en la que se usa el archivo de configuración cuando configuras la variable de entorno BOTO_CONFIG. También puedes configurar una ruta de archivos de configuración boto para cargar si configuras la variable de entorno BOTO_PATH. Eso te puede ser útil, por ejemplo, cuando compartes datos y situaciones de colaboración, como en el ejemplo a continuación.

Para obtener una lista completa de lo que contiene el archivo de configuración boto, consulta la configuración de gsutil.

Ejemplo de colaboración con boto

En este ejemplo, una empresa pequeña quiere usar Cloud Storage como un sistema de almacenamiento para sus empleados. Como administrador de TI, creas un proyecto en Google Cloud Platform Console y creas depósitos para cada empleado. A fin de facilitarles el uso de Cloud Storage a los empleados, creas y almacenas configuraciones para toda la empresa, como una configuración proxy y umbrales de carga compuestos paralelos en un archivo central al que los empleados puedan apuntar su ruta de configuración BOTO. Esto es para que cada empleado no tenga que configurar las partes compartidas de la configuración de manera manual y te permite, como el administrador, cambiar esas configuraciones compartidas, si es necesario.

Para lograrlo, realiza los pasos siguientes:

  1. Crea un archivo de configuración central boto que puedan leer todos los empleados.

    Eso se puede hacer con gcloud init cuando se instala gsutil como parte del SDK de Google Cloud.

    El archivo de configuración boto podría contener, por ejemplo:

    [Boto]
    proxy = yourproxy.com
    proxy_port = 8080
    
    [GSUtil]
    parallel_composite_upload_threshold = 150M
    
  2. Indica a los empleados que instalen el SDK de Google Cloud.

    Durante la instalación, los empleados especifican el ID del proyecto que usa la empresa. También tienen que generar credenciales de autenticación individuales debido a que no puedes compartir las credenciales de autenticación de manera centralizada.

  3. Indica a los empleados que agreguen una variable de entorno BOTO_PATH.

    La variable de entorno BOTO_PATH hace una lista de la ruta del archivo de configuración ubicado de manera central, seguida del archivo de configuración local del empleado. Por ejemplo, si el archivo de configuración central está ubicado en el directorio centralhub/, la variable de entorno BOTO_PATH para el usuario jane podría ser:

    BOTO_PATH =/centralhub/boto.cfg:home/jane/.boto

Cuando los empleados ejecutan gsutil, usan de manera automática la configuración especificada en el archivo boto central. Si es necesario, el administrador puede cambiar la configuración del proxy, el umbral de carga compuesto paralelo y otras configuraciones en el archivo de configuración central y hacer que los cambios se reflejen para todos los empleados que usan ese archivo.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.