gs: add source and sink for Google Cloud Storage
authorJulien <jisorce@oblong.com>
Tue, 23 Jun 2020 19:41:27 +0000 (12:41 -0700)
committerJulien Isorce <julien.isorce@gmail.com>
Thu, 18 Mar 2021 22:32:48 +0000 (22:32 +0000)
commite9f5d94c9304aaae4ffc27ffeae1f7c49c4d3e57
tree14aec729f1da39a58b0106dd7e5aae9793e97833
parent872b7f503c49442e559f6a381416c6a84b76a3c6
gs: add source and sink for Google Cloud Storage

Useful when having a service that runs a GStreamer pipeline
or application in Google Cloud to avoid storing the inputs
and outputs in the running container or service. For example
when analyzing a video from a Google Cloud Storage bucket
and extracting images or converting the video and then uploading
the results into another Google Cloud Storage bucket.

- gssrc allows to read from a file located in Google Cloud
Storage and it supports seeking.
- gssink allows to write to a file located in Google Cloud
Storage. There are 2 modes, one similar to multifilesink and
the other similar to filesink.

Example:
  gst-launch-1.0 gssrc location=gs://mybucket/videos/sample.mp4 ! decodebin ! glimagesink
  gst-launch-1.0 playbin uri=gs://mybucket/videos/sample.mp4
  gst-launch-1.0 videotestsrc num-buffers=5 ! pngenc ! gssink object-name="img/img%05d.png" bucket-name="mybucket" next-file=buffer
  gst-launch-1.0 filesrc location=sample.mp4 ! gssink object-name="videos/video.mp4" bucket-name="mybucket" next-file=none

When running locally simply set GOOGLE_APPLICATION_CREDENTIALS. But
when running in Google Cloud Run or Google Cloud Engine, just set the
"service-account-email" property on each element.

Closes #1264

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1369>
13 files changed:
docs/plugins/gst_plugins_cache.json
ext/gs/.clang-format [new file with mode: 0644]
ext/gs/README.md [new file with mode: 0644]
ext/gs/gstgs.cpp [new file with mode: 0644]
ext/gs/gstgscommon.cpp [new file with mode: 0644]
ext/gs/gstgscommon.h [new file with mode: 0644]
ext/gs/gstgssink.cpp [new file with mode: 0644]
ext/gs/gstgssink.h [new file with mode: 0644]
ext/gs/gstgssrc.cpp [new file with mode: 0644]
ext/gs/gstgssrc.h [new file with mode: 0644]
ext/gs/meson.build [new file with mode: 0644]
ext/meson.build
meson_options.txt