菲斯和达尔马提亚的宽松包装
lapdog的Python项目详细描述
拉普狗
一款适合达尔马提亚人和菲斯人的宽松包装纸
先决条件
- lapdog需要macos或linux。Windows不受官方支持
- lapdog需要python>；=3.3
- lapdog需要google cloud sdk，可以在这里安装。
- 您的gcloud--version应该至少为252.0。如果不是，请运行
gcloud components update
- 您的gcloud--version应该至少为252.0。如果不是，请运行
- lapdog使用您的gcloud应用程序默认凭据
- 在运行lapdog之前使用
gcloud auth application default login和gcloud config set account{account}
- 在运行lapdog之前使用
- lapdog需要gcloud的alpha和beta套件
- alpha和beta套件可以与
gcloud components install alpha beta一起安装
- alpha和beta套件可以与
- （可选）lapdog用户界面需要node和npm，可以使用系统的包管理器安装node和npm
- MacOS:
Brew安装节点NPM - Linux：通过系统包管理器安装，或从源代码安装
- lapdog要求node--version>；=10.15.1
- lapdog要求
npm--version>；=6.4.1
- MacOS:
安装
- 通过pip安装lapdog：
pip安装lapdog- 如果你已经安装了lapdog，你可以用
pip安装--升级lapdog - 如果您遇到pyyaml错误，请参见下面的pyyaml note。
- 如果你已经安装了lapdog，你可以用
- （可选）启用LapDog用户界面：
- 默认情况下，ui在本地运行。如果你在服务器上安装lapdog，你将 需要为端口4200和4201设置ssh隧道
- 如果尚未安装节点和npm，请安装它们
- 如果您使用的是Mac OS，请运行
Brew安装节点NPM
- 如果您使用的是Mac OS，请运行
- 运行
lapdog ui--install。这可能需要一段时间
用法
lapdog可以在python中导入，作为dalmatian- lapdog提供了达尔马提亚语的超集功能
workspacemanagers与firecloud通信时，在lappog缓存数据中。 如果Firecloud遇到间歇性故障，则工作空间管理器可能 能够在脱机模式下继续运行。调用workspacemanager.sync（）将 重新连接到FireCloud，推出脱机模式下排队的所有数据更新workspacemanagers在lapdog中通过workspacemanager.execute（）显示执行api。 执行不同于提交，因为它们直接在google上运行，结果是 之后上传回Firecloud
lapdog可用作命令行工具。- 该工具提供了创建工作区、填充数据所需的功能， 导入或上载方法和配置，并提交作业（或直接执行它们）
- 运行
lapdog--help以获取可用命令的列表
lapdog可通过一个交互式用户界面使用，该界面用于运行和 监视lapdog执行- 运行
lapdog ui启动用户界面
- 运行
作业执行
lapdog通过每个firecloud名称空间的专用google项目（"引擎"）执行作业。
lapdog引擎只能由帐单帐户adm为给定的命名空间初始化在。
要初始化新引擎，请与命名空间管理员联系，让他们运行lapdog initialize project
初始化引擎后，您必须向它注册：
- 当您加载工作区时，lapdog用户界面将自动注册您 在您未注册到的命名空间中
- lapdog python模块支持手动注册
- 在未注册的命名空间中创建工作空间管理器时，将收到警告
- 您还可以通过检查workspacemanager.gateway.registered的值来检查注册状态
- 然后，您可以使用
workspacemanager.gateway.register（）进行注册- 如果注册由于任何firecloud错误而失败，只需等待几分钟 然后再次尝试调用register（）
- lapdog cli不支持注册。您可以通过ui注册，或者 python模块
工作区权限
在ui中，在每个页面的底部，您都会找到一封firecloud.org电子邮件。 这是一封代理组电子邮件，其中包含您和您的所有服务帐户。 要允许lapdog引擎运行作业，必须授予代理组电子邮件 对运行作业的FireCloud工作区的写访问。你可以批准这个团体 对将从中读取数据但作业无法执行的工作区的读取访问 在没有写权限的工作区中。代理组电子邮件可以通过 为用户（您的电子邮件）调用lapdog.cloud.proxy\u group
