Databricks Terraform提供商

需求

若要使用Terraform在AWS帐户级别创建资源，以及使用Databricks Terraform提供程序在Databricks在AWS帐户级别创建资源，您必须具备以下条件:

• AWS帐户。

• “AWS上的数据库”帐户。

• Databricks帐户中的帐户级别的管理员用户。

• Terraform命令行。看到下载起程拓殖在Terraform网站上。

• 以下七个数据库环境变量：

  • DATABRICKS_USERNAME，设置为Databricks帐户级admin用户名。

  • DATABRICKS_PASSWORD，设置为Databricks帐户级admin用户的密码值。

  • DATABRICKS_ACCOUNT_ID，设置为“Databricks”帐号的ID。你可以在你的Databricks帐户控制台．

  • TF_VAR_databricks_account_id，也设置为您的Databricks帐户ID的值。

  • AWS_ACCESS_KEY_ID，设置为AWS用户的访问密钥ID的值。看到编程访问在AWS通用参考中。

  • AWS_SECRET_ACCESS_KEY，设置为AWS用户的秘密访问密钥的值。看到编程访问在AWS通用参考中。

  • AWS_REGION，设置为您的Databricks帐户的AWS区域代码的值。看到区域端点在AWS通用参考中。

  请注意

  作为安全最佳实践，当使用自动化工具、系统、脚本和应用程序进行身份验证时，Databricks建议您使用属于的访问令牌服务主体而不是工作区用户。要为服务主体创建访问令牌，请参见管理服务主体的访问令牌．

  要设置这些环境变量，请参阅操作系统的文档。

要使用Databricks Terraform提供程序在Databricks工作空间级别创建资源，必须具备以下条件:

• 一个Databricks工作区。

• 在你的本地开发机器上，你必须有:

  • Terraform命令行。看到下载起程拓殖在Terraform网站上。

  • 下列其中一项:

    • Databricks命令行界面(Databricks CLI)，配置您的Databricks工作空间实例URL例如，https://dbc-1234567890123456.cloud.www.neidfyre.com，以及你的数据库个人访问令牌，通过跑步砖配置——令牌．看到设置CLI而且设置身份验证．

      请注意

      作为安全最佳实践，当使用自动化工具、系统、脚本和应用程序进行身份验证时，Databricks建议您使用属于的访问令牌服务主体而不是工作区用户。要为服务主体创建访问令牌，请参见管理服务主体的访问令牌．

    • 下面两个数据库环境变量：

      • DATABRICKS_HOST，设置为“数据库”的值工作空间实例URL例如，https://dbc-1234567890123456.cloud.www.neidfyre.com

      • DATABRICKS_TOKEN，设置为“数据库”的值个人访问令牌．另请参阅管理个人访问令牌．

      要设置这些环境变量，请参阅操作系统的文档。

      请注意

      作为安全最佳实践，当使用自动化工具、系统、脚本和应用程序进行身份验证时，Databricks建议您使用属于的访问令牌服务主体而不是工作区用户。要为服务主体创建访问令牌，请参见管理服务主体的访问令牌．

配置Terraform认证

在您的Terraform项目中，您必须创建一个配置，以使用您的AWS帐户验证Terraform，并使用Databricks on AWS帐户和Databricks工作区验证Databricks Terraform提供者，如下所示:

1. 在终端中创建一个空目录，然后切换到该目录。(每一组单独的Terraform配置文件必须在其自己的目录中，该目录称为Terraform项目)。例如:mkdirterraform_demo& &cdterraform_demo．

   mkdir terraform_demo& &cdterraform_demo

2. 在这个空目录中，创建一个名为auth.tf．根据您的身份验证方法，将以下内容添加到该文件中，然后保存该文件。

   提示

   如果使用Visual Studio Code，则HashiCorp起程拓殖Visual Studio Code扩展为Terraform文件添加了编辑功能，如语法高亮显示、智能感知、代码导航、代码格式化、模块资源管理器等等。

   要使用环境变量在AWS帐户级别进行身份验证，并在AWS帐户级别使用Databricks CLI配置概要文件在Databricks工作空间级别进行身份验证，请添加以下内容。

   变量“databricks_connection_profile”{}起程拓殖｛required_providers｛砖＝｛源＝“砖/砖”｝aws＝｛源＝“hashicorp / aws”｝｝｝提供者“aws”{}#使用Databricks CLI认证。提供者“砖”｛配置文件＝var．databricks_connection_profile｝

   若要使用环境变量在AWS帐户级别、AWS帐户级别的Databricks和Databricks工作区级别进行身份验证，请添加以下内容:

   起程拓殖｛required_providers｛砖＝｛源＝“砖/砖”｝aws＝｛源＝“hashicorp / aws”｝｝｝提供者“aws”{}使用环境变量进行身份验证。提供者“砖”{}

   提示

   如果希望仅在Databricks工作区级别创建资源，则可以删除aws阻止前面的任何一个required_providers声明以及提供者“aws”声明。

3. 如果使用Databricks CLI配置文件在Databricks工作空间级别进行身份验证，请创建另一个名为auth.auto.tfvars，在文件中添加以下内容，并根据需要更改要使用的配置文件的名称:

   databricks_connection_profile＝“默认”

   提示

   * .auto.tfvars文件使您能够从代码中单独指定变量值。这使你的.tf文件在不同的使用场景中更加模块化和可重用。

4. 初始化包含auth.tf通过运行起程拓殖初始化命令。有关更多信息，请参见命令:初始化在Terraform网站上。

   起程拓殖init

   Terraform下载指定的提供程序，并将它们安装到当前工作目录的隐藏子目录中.terraform．的起程拓殖初始化命令输出安装的提供程序版本。Terraform还创建了一个名为.terraform.lock.hcl它指定使用的确切提供程序版本，以便您可以控制何时要更新项目使用的提供程序。

5. 命令检查项目是否配置正确起程拓殖计划命令。如果有错误，请修复后重新执行命令。有关更多信息，请参见命令:计划在Terraform网站上。

   起程拓殖计划

6. 命令应用所需的更改，以达到所需的配置状态起程拓殖应用命令。有关更多信息，请参见命令:在Terraform网站上。

   起程拓殖应用

   类型中尚未指定任何资源auth.tf文件，输出为应用完成了!资源:0补充说,0改变,0摧毁。此外，Terraform将数据写入一个名为terraform.tfstate．若要创建资源，请继续示例配置，下一个步骤，或同时指定所需的资源来创建，然后运行起程拓殖应用再次命令。Terraform将其管理的资源的id和属性存储在此文件中terraform.tfstate文件，这样它就可以更新或销毁这些资源。

错误:安装提供程序失败

问题:如果您没有办理登机手续terraform.lock.hcl文件到版本控制系统，然后运行起程拓殖初始化命令，显示如下信息:失败的来安装提供者．额外的输出可能包括类似于以下的消息:

安装databrickslab /databricks时出现错误:v1.0.0:校验和列表没有“https://github.com/databricks/terraform-provider-databricks/releases/download/v1.0.0/terraform-provider-databricks_1.0.0_darwin_amd64.zip”的SHA-256哈希

导致:您的Terraform配置引用了过时的Databricks Terraform提供程序。

解决方案：

1. 取代databrickslabs /砖与砖/砖在你们所有的.tf文件。

   的父文件夹中运行以下Python命令，以自动执行这些替换.tf需要更新的文件:

   python3-c"$(curl -Ls https://dbricks.co/updtfns)"

2. 运行以下Terraform命令，然后在提示时批准更改:

   Terraform state replace-provider databrickslab /databricks databricks/databricks

   有关此命令的信息，请参见命令:state replace-provider在Terraform文档中。

3. 执行以下Terraform命令验证更改:

   起程拓殖init

错误:查询可用的提供程序包失败

问题:如果您没有办理登机手续terraform.lock.hcl文件到版本控制系统，然后运行起程拓殖初始化命令，显示如下信息:失败的来查询可用提供者包．

导致:您的Terraform配置引用了过时的Databricks Terraform提供程序。

解决方案:请参考错误:安装提供程序失败．