mozilla / bigquery-etl

Bigquery ETL
https://mozilla.github.io/bigquery-etl
Mozilla Public License 2.0
253 stars 100 forks source link

Document Jenkins usage #2239

Open whd opened 3 years ago

whd commented 3 years ago

There have been a couple of PRs that have broken automated views deploys due to permissions errors, most recently:

https://github.com/mozilla/bigquery-etl/issues/2212 https://github.com/mozilla/bigquery-etl/issues/2214 https://github.com/mozilla/bigquery-etl/pull/2238

The behavior of jenkins (running containers as a non-root user, and therefore being unable to modify the contents of the /app directory) is not well documented and it's not clear to developers that bqetl logic has this as a potential runtime constraint. The purpose of --sql-dir to specify an alternate writable location I think is mostly to support the Jenkins use case. There is a comment in https://github.com/mozilla-services/cloudops-infra/blob/master/projects/data-shared/Jenkinsfile.bigquery.prod#L135 that explains the cp -R sql /tmp/sql line but it might make sense to document or otherwise modify bqetl CI to catch this in CI.

kik-kik commented 1 year ago

@whd is this still relevant?