Guía de inicio rápido

En esta página, se explica cómo ejecutar una canalización de genómica que utiliza la API de Cloud Life Sciences para crear un archivo de índice (archivo BAI) a partir de un archivo binario que contiene secuencias de ADN (archivo BAM). Los archivos BAM suelen ser grandes y pueden llevar mucho tiempo en un lector de genomas. Usas un archivo BAI para ubicar las partes del archivo BAM que contienen la posición del genoma que te interesa.

Antes de comenzar

Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

Ir al selector de proyectos
Comprueba que la facturación esté habilitada en tu proyecto.

Descubre cómo puedes habilitar la facturación

Habilita las API de Cloud Life Sciences, Compute Engine, and Cloud Storage JSON.
Habilita las API

Instala e inicializa el SDK de Cloud.

También puedes usar Cloud Shell, que ya tiene instalado el SDK de Cloud.

Instala Python 3.8.
Si usas Windows y dejaste la casilla de verificación correspondiente seleccionada cuando instalaste el SDK de Cloud, esto se hizo de forma automática.

Ejecuta la canalización

Para ejecutar la canalización, completa los siguientes pasos:

Crea un bucket en el que almacenarás el archivo BAI. Los depósitos son los contenedores básicos que conservan tus datos en Cloud Storage. Para crear un bucket llamado PROJECT_ID-life-sciences, ejecuta el comando gsutil mb:
```
gsutil mb gs://PROJECT_ID-life-sciences
```
Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud. Debes usar un nombre de bucket único a nivel global.
Consulta los requisitos para nombrar los depósitos.
- Los nombres de los buckets deben contener solo letras minúsculas, números, guiones (-), guiones bajos (_) y puntos (.). No se permiten espacios. Los nombres que contienen puntos se deben verificar.
- Deben comenzar y terminar con un número o una letra.
- Pueden contener entre 3 y 63 caracteres. Los nombres que contienen puntos pueden contener hasta 222 caracteres, pero cada componente separado por puntos no puede tener más de 63 caracteres.
- No se pueden representar como una dirección IP en notación decimal con puntos (por ejemplo, 192.168.5.4).
- No pueden comenzar con el prefijo "goog".
- No pueden contener "google" ni palabras parecidas que estén mal escritas, como "g00gle".
Precaución: No incluyas información sensible en el nombre del bucket, ya que su espacio de nombres es global y público. visible.

Si se completa correctamente, el comando muestra lo siguiente:
```
Creating gs://PROJECT_ID-life-sciences
```

Para iniciar la canalización, ejecuta el comando gcloud beta lifesciences pipelines run:

gcloud beta lifesciences pipelines run \
    --regions us-east1 \
    --command-line 'samtools index ${BAM} ${BAI}' \
    --docker-image "gcr.io/cloud-lifesciences/samtools" \
    --inputs BAM=gs://genomics-public-data/NA12878.chr20.sample.bam \
    --outputs BAI=gs://PROJECT_ID-life-sciences/NA12878.chr20.sample.bam.bai

Si se completa correctamente, el comando muestra lo siguiente:

Running [projects/PROJECT_ID/operations/OPERATION_ID]

Ten en cuenta la OPERATION_ID, que usarás en el siguiente paso.

Para realizar un seguimiento del estado de la canalización, ejecuta el comando gcloud beta lifesciences operations wait. Reemplaza OPERATION_ID por el valor impreso en el paso anterior. La canalización tarda unos minutos en finalizar.
```
gcloud beta lifesciences operations wait OPERATION_ID
```
Después de que la operación finaliza, muestra el mensaje siguiente:
```
Waiting for [projects/PROJECT_ID/operations/OPERATION_ID]...done.
```
Para verificar que se haya generado el archivo BAI, ejecute el comando gsutil ls:
```
gsutil ls gs://PROJECT_ID-life-sciences
```
Si se completa correctamente, el comando muestra lo siguiente:
```
gs://PROJECT_ID-life-sciences/NA12878.chr20.sample.bam.bai
```

Ejecutaste una canalización con la API de Cloud Life Sciences para crear un archivo BAI a partir de un archivo BAM. Usa un visor de genomas para examinar el archivo NA12878.chr20.sample.bam BAM con el archivo de índice NA12878.chr20.sample.bam.bai.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Borra el archivo BAI

Para borrar el archivo BAI generado, pero conservar el proyecto y el bucket que creaste, ejecuta el comando gsutil rm:

gsutil rm PROJECT_ID-life-sciences/NA12878.chr20.sample.bam.bai

Borra el bucket

Si creaste el bucket específicamente para esta guía de inicio rápido y ya no lo necesitas, pero quieres conservar tu proyecto, borra el bucket con el comando gsutil rb. Cuando se borra el bucket también se borra el archivo BAI generado.

gsutil rb gs://PROJECT_ID-life-sciences

Borra el proyecto

Si creaste el proyecto específicamente para esta guía de inicio rápido y ya no lo necesitas, puedes borrarlo. Si borras el proyecto, también se borra el archivo BAI y el bucket de Cloud Storage.

Precaución: Borrar un proyecto tiene estas consecuencias:

Se borra todo en el proyecto. Si utilizaste un proyecto existente para este instructivo, cuando lo borres, también borrarás cualquier otro trabajo que hayas realizado en el proyecto.
Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varios instructivos y guías de inicio rápido, la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

En Cloud Console, ve a la página Administrar recursos.
Ir a Administrar recursos
En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.