Adds a BCFtools-gcs installer doc#179
Conversation
EddieLF
left a comment
There was a problem hiding this comment.
Looks good, glad to add some proper docs for this. A few small notes
-
Is it worth expanding this to include
samtoolscommands as well? AFAIK the GCS connecting aspect is identical and most commands are similar. -
Might be worth mentioning that you should already have gcloud installed and authed, and maybe a note on access policies for data in buckets - i.e. you will need the right permissions or a PAM approval to access
-mainbucket files. There are some "instructions" for gcloud install and auth here and for data access here. -
I think we can export the
GCS_OAUTH_TOKENvariable to our environment and then drop it from the commands.
I've always begun mysamtoolsandbcftoolscommands withGCS_OAUTH_TOKEN=$(gcloud auth application-default print-access-token) ..., but this comment on a biostars forum post shows you can export the env variable and then it will just work. So it might be good to add that you can stickexport GCS_OAUTH_TOKEN=$(gcloud auth print-access-token)into your.zshrc
|
Adding samtools to this is a good idea, I'll shove that in too. I'm planning to also make a from-zero page on gcloud setup, and once that exists this can link to that. exporting it makes sense, tidies things up. I'll expand this page by being more explicit that |
|
Alright, maybe this problem is somehow unique to me... the brew-installed version may or may not work just fine 🫠 |
Context: I'm setting up a fresh laptop, and while this repo should contain a baby steps setup guide for core tools, it seems more focused on setting up a terminal with a RAD colour scheme. I'm planning to add help pages describing from-zero setup in more detail than this repo currently contains. This is a first page covering the steps I've needed for bcftools-gcs-gcloud to all play nicely on a new Mac.
Adds a step-by-step installation process for bcftools, configured for interacting with GCS. These steps broadly follow the standard installation steps here, but with some extra details:
gcclibcurldidn't play well with me, spitting out endlesslibcurl_open...Retryingerror messages; unsure if I'm very unlucky, or if this is a general issue. The fix described here solved this for me, but I had a working install on my previous laptop and I don't remember requiring these steps. Though.. I did have a non-standard curl on that laptop... maybe it was installed outside of homebrew to the same effect