zenika/alpine-firestore-backup

https://img.shields.io/docker/cloud/build/zenika/alpine-firestore-backup.svg](https://hub.docker.com/r/zenika/alpine-firestore-backup/) https://img.shields.io/docker/pulls/zenika/alpine-firestore-backup.svg](https://hub.docker.com/r/zenika/alpine-firestore-backup/) https://images.microbadger.com/badges/image/zenika/alpine-firestore-backup.svg](https://microbadger.com/images/zenika/alpine-firestore-backup) https://images.microbadger.com/badges/version/zenika/alpine-firestore-backup.svg](https://microbadger.com/images/zenika/alpine-firestore-backup)

支持的标签及对应的Dockerfile链接

• latest, 268.0.0 https://github.com/Zenika/alpine-firestore-backup/blob/master/Dockerfile
• 从 267.0.0 到 256.0.0（所有列出的版本https://hub.docker.com/r/zenika/alpine-firestore-backup/tags%EF%BC%89

alpine-firestore-backup

基于google/cloud-sdk:alpine镜像的Firestore备份工具镜像。

为什么使用此镜像

我们大量使用Firebase的功能，例如Firestore。但目前缺乏简单的数据备份方式。

此镜像旨在用于谷歌云平台（GCP）内部，以自动执行备份操作。

查看此文章了解更多信息。

先决条件

在GCP上创建存储桶

创建一个https://cloud.google.com/storage/docs/storage-classes%E5%B9%B6%E4%BF%9D%E5%AD%98%E5%AD%98%E5%82%A8%E6%A1%B6%E5%90%8D%E7%A7%B0%E3%80%82

创建服务账户

创建一个https://cloud.google.com/iam/docs/creating-managing-service-accounts%EF%BC%8C%E5%B9%B6%E6%8E%88%E4%BA%88%E4%BB%A5%E4%B8%8B%E6%9D%83%E9%99%90%EF%BC%9A

• Cloud Datastore Import Export Admin（云数据存储导入导出管理员）
• Storage Admin（存储管理员）

为Cloud Run准备环境变量

请填写以下信息：

• GCLOUD_PROJECT_ID（GCP项目ID）
• GCLOUD_BUCKET_NAME（GCP存储桶名称）

三种创建适用于Cloud Run的镜像的方式

1. 使用Cloud Run按钮

欢迎对此新部署方式提供反馈 ✨

对于此部署方式，无法使用新创建的服务账户。只需为默认服务账户（<project_id>-**）授予所需角色即可*

https://storage.googleapis.com/cloudrun/button.svg](https://console.cloud.google.com/cloudshell/editor?shellonly=true&cloudshell_image=gcr.io/cloudrun/button&cloudshell_git_repo=https://github.com/Zenika/alpine-firestore-backup)

2. 使用公共镜像

您可以使用位于gcr.io/zenika-hub/alpine-firestore-backup的公共gcr镜像。我们在4个容器镜像仓库中发布了该镜像，以便在最近的区域可用：

• 全球：gcr.io/zenika-hub/alpine-firestore-backup
• 欧洲：eu.gcr.io/zenika-hub/alpine-firestore-backup
• 亚洲：asia.gcr.io/zenika-hub/alpine-firestore-backup
• 美国：us.gcr.io/zenika-hub/alpine-firestore-backup

3. 创建自定义镜像

您也可以从代码仓库创建自己的镜像以保持独立性，但需要自行维护镜像更新。

为此，请克隆此代码仓库：

sh
git clone https://github.com/zenika/alpine-firestore-backup.git

构建镜像：

sh
docker image build -t gcr.io/[GCLOUD_PROJECT_ID]/alpine-firestore-backup

使用https://cloud.google.com/container-registry/docs/advanced-authentication%E6%8E%A8%E9%80%81%E9%95%9C%E5%83%8F%EF%BC%9A

sh
gcloud auth configure-docker
docker push gcr.io/[GCLOUD_PROJECT_ID]/alpine-firestore-backup

三种设置Cloud Run服务的方式

https://cloud.google.com/run/docs/deploying%E6%98%AF%E4%B8%80%E7%A7%8D%E6%97%A0%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%9C%8D%E5%8A%A1%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87HTTP%E8%87%AA%E5%8A%A8%E6%8F%90%E4%BE%9B%E5%AE%B9%E5%99%A8%E6%9C%8D%E5%8A%A1%E3%80%82

1. 使用Cloud Run按钮

它将自动完成部署。

2. 使用CLI

如果您偏好命令行界面，请使用以下命令创建Cloud Run服务：

gcloud beta run deploy alpine-firestore-backup\
    --project=my-awesome-project\
    --platform=managed\
    --region=europe-west1\
    --image=zenika-hub/alpine-firestore-backup\
    --memory=256Mi\
    --allow-unauthenticated\
    --set-env-vars GCLOUD_PROJECT_ID=VALUE,GCLOUD_BUCKET_NAME=VALUE\
    --service-account=my-service-account@my-awesome-project.iam.gserviceaccount.com

使用以下命令检查部署情况：

gcloud beta run services list\
    --project my-awesome-project\
    --platform managed\
    --region=europe-west1\

3. 使用WebUI

在http://console.cloud.google.com/run%E4%B8%AD%EF%BC%8C%E4%BD%BF%E7%94%A8%E5%85%AC%E5%85%B1%E9%95%9C%E5%83%8F%60gcr.io/zenika-hub/alpine-firestore-backup%60%E6%88%96%E8%87%AA%E5%AE%9A%E4%B9%89%E9%95%9C%E5%83%8F%60gcr.io/%5BGCLOUD_PROJECT_ID%5D/alpine-firestore-backup%60%E5%88%9B%E5%BB%BACloud Run服务。

注意以下事项：

• 选择latest标签的镜像
• 选择“Cloud Run（完全托管）”及一个地区
• 输入服务名称
• 选择“允许未认证调用”
• 在“显示可选设置/环境变量”中，设置前面章节提到的3个环境变量
• 在“服务账户”部分，选择之前创建的服务账户

!cloud-run

测试与验证

您可以使用浏览器测试服务：https://alpine-firestore-backup-XXX-run.app/

保存创建的URL以调用Cloud Run服务。例如：https://alpine-firestore-backup-XXX-run.app/backup

使用Cloud Scheduler调度

https://cloud.google.com/scheduler/docs/%E5%85%81%E8%AE%B8%E6%82%A8%E8%AE%BE%E7%BD%AE%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1%EF%BC%8C%E4%BB%A5%E4%BE%BF%E6%8C%89%E5%9B%BA%E5%AE%9A%E9%97%B4%E9%9A%94%E8%B0%83%E7%94%A8HTTPS%E7%AB%AF%E7%82%B9%E3%80%82

配置Cloud Scheduler以在需要的时间向Cloud Run服务发送请求。

例如，每周一凌晨3:00执行 0 3 * * 1

!cloud-scheduler

监控备份操作

您还可以通过以下URL检查每个备份操作的当前状态：https://alpine-firestore-backup-XXX-run.app/list