只需创建一个 Looker 用户主目录(包括所有普通和隐藏子目录)的副本,即可创建基本的 Looker 安装备份。您可以通过 scp
、rsync
或任何标准备份应用来实现此目的。同样,恢复基本的 Looker 安装只需恢复文件并启动 Looker。
在某些配置(包括集群环境)中,Looker 使用外部 MySQL 数据库进行应用设置、用户帐号和其他数据。在这种情况下,除了 Looker 主目录之外,我们还建议您创建 MySQL 数据库的备份。
我们强烈建议您每天创建这些备份。我们还建议每季度执行一次测试恢复。
目录结构
Looker 用户主目录(通常是 /home/looker)下的标准子目录的说明如下。
folder 首页
folder Looker
folder .ssh
folder Looker
folder .cache
folder .db
folder .ssl
folder .tmp
folder deploy_keys
folder log
folder models
folder models-user-1
目录 | 需要备份 | 更改频率 | 说明 |
---|---|---|---|
.ssh | 是 | 很少 | 用于对 Git 进行身份验证的 SSH 密钥,适用于使用 Looker 4.6 或更低版本创建的 LookML 项目 |
Looker/.cache | 否 | 常用 | 临时缓存文件 |
Looker/.db | 是,除非后端数据库已迁移到 MySQL | 常用 | Looker 内部数据库 |
Looker/.snapshots | 否 | 更新时 | Looker jar 和 .db 目录的备份副本会在更新期间存储在此处 |
Looker/.ssl | 不确定 | 很少 | 自签名 SSL 证书(请参阅备注) |
Looker/.tmp | 否 | 常用 | 临时文件 |
Looker/deploy_keys | 是 | 很少 | 用于对使用 Looker 4.8 或更高版本创建的 LookML 项目的 Git 进行身份验证的 SSH 密钥 |
Looker/log | 不确定 | 常用 | 日志文件;仅在保留政策要求时才需要使用 |
Looker/models | 否 | 变量 | 从源代码库(通常是 GitHub)复制的生产环境模型 |
Looker/models-user-* | 是 | 变量 | 每个用户的开发模型都存储在不同的 ID 中,其中包含用户的 ID 编号 |
SSL 注意:默认情况下,SSL 目录仅包含自签名 SSL 证书,不需要保留。但是,如果您在此目录中存储了任何其他文件(例如由证书授权机构签名的 SSL 证书),则应将该目录添加到您的备份中。
Looker 主目录之外应添加到备份的文件包括:
目录 | 需要备份 | 更改频率 | 说明 |
---|---|---|---|
/etc/init.d/looker | 是 | 很少 | Looker 的系统启动脚本 |
SSL 证书 | 是 | 很少 | 如果您使用的是 SSL 证书,请确保包含所有必需的文件 |
虽然这通常不会引发问题,但有些客户报告称,如果备份中包含
looker/.db/looker.lck
文件,就会出现问题。您可以根据需要安全地排除此文件。
创建 Looker 备份
您可以使用任何标准备份应用以及 rsync 等命令行工具创建 Looker 备份。
建议在应用尽可能少用时运行备份流程。除了正常的用户互动之外,还要考虑定期运行的 Looks 可能运行的时间、派生的表格可能正在重新构建等。
集群环境
Clustered Looker 将其应用配置、用户帐号和其他数据存储在外部 MySQL 数据库中。我们建议与 Looker 应用同时创建此数据库的备份。如需详细了解如何备份 MySQL 数据库,请参阅 MySQL 文档。
生成独立于密钥库的备份
如果客户托管的安装已迁移到 AES-256 GCM 加密并且未使用 AWS KMS,则可以使用此过程创建其 Looker 实例的备份,该备份独立于其本地客户主密钥 (CMK)。这样一来,自托管客户无需提供 CMK 即可迁移到 Looker 托管的安装,或者将客户托管的安装移至无权访问同一本地密钥库的新主机。
如需创建独立于密钥库的备份,请执行以下操作:
Stop Looker:
cd looker ./looker stop
如果 Looker 已聚类,请务必先停止每个节点,然后再继续操作。
确保 Looker 可以访问您的 CMK。如果您的 CMK 存储在文件中,可以使用环境变量
LKR_MASTER_KEY_FILE
指向您的 CMK 文件的路径:export LKR_MASTER_KEY_FILE=<path_to_CMK_file>
或者,如需在环境变量中直接提供 CMK,您可以使用
LKR_MASTER_KEY_ENV
环境变量:export LKR_MASTER_KEY_ENV=<CMK_value>
生成一个新密钥文件,该文件将用于重新加密密钥加密密钥 (KEK):
./looker generate_keyfile_for_backup <key_file_name>
其中,
<key_file_name>
是要用于 Looker 将创建的文件,然后用于写入新键的名称。新密钥文件的内容将如下所示:
{"dbmk":"vr1LUwO3q6weY8iS3JykVljSjiD4m6eGk227Cs7Qu9Q=\n","backup_uid":"XCXvRa38mNeqT6+HRBCo2Q=="}
其中
dbmk
的值是 Base64 编码的 256 位加密密钥,backup_uid
是将密钥保存到数据库时使用的唯一名称。使用新密钥文件在 Looker 的内部数据库中创建新的密钥条目:
./looker keystore_independent_recrypt <key_file_name>
其中
<key_file_name>
是之前创建的密钥文件。这会使用 CMK 解密内部数据库中的 KEK,然后使用新密钥重新加密 KEK,并将这个加密的值保留到数据库中。
使用常规备份方法创建 Looker 备份。
如需恢复这个独立于密钥库的备份,您需要之前创建的新密钥文件。
恢复备份
如需恢复 Looker 备份,请参阅恢复备份文档页面。
后续步骤
设置备份后,您就可以确保 Looker 可以访问必要的服务了。