资源中心配置详情

资源中心通常用于上传文件、 UDF 函数，以及任务组管理等操作。针对单机环境可以选择本地文件目录作为上传文件夹（此操作不需要部署 Hadoop）。当然也可以选择上传到 Hadoop or MinIO 集群上，此时则需要有 Hadoop（2.6+）或者 MinIOn 等相关环境。

本地资源配置

在单机环境下，可以选择使用本地文件目录作为上传文件夹（无需部署Hadoop），此时需要进行如下配置：

配置 common.properties 文件

对以下路径的文件进行配置：api-server/conf/common.properties 和 worker-server/conf/common.properties

  • 将 data.basedir.path 改为本地存储路径，请确保部署 DolphinScheduler 的用户拥有读写权限，例如：data.basedir.path=/tmp/dolphinscheduler。当路径不存在时会自动创建文件夹
  • 修改下列两个参数，分别是 resource.storage.type=HDFS 和 fs.defaultFS=file:///。

HDFS 资源配置

当需要使用资源中心进行相关文件的创建或者上传操作时，所有的文件和资源都会被存储在 HDFS 上。所以需要进行以下配置：

配置 common.properties 文件

在 3.0.0-alpha 版本之后，如果需要使用到资源中心的 HDFS 或 S3 上传资源，我们需要对以下路径的进行配置：api-server/conf/common.properties 和 worker-server/conf/common.properties。可参考如下：

  1. #
  2. # Licensed to the Apache Software Foundation (ASF) under one or more
  3. # contributor license agreements.  See the NOTICE file distributed with
  4. # this work for additional information regarding copyright ownership.
  5. # The ASF licenses this file to You under the Apache License, Version 2.0
  6. # (the "License"); you may not use this file except in compliance with
  7. # the License.  You may obtain a copy of the License at
  8. #
  9. #     http://www.apache.org/licenses/LICENSE-2.0
  10. #
  11. # Unless required by applicable law or agreed to in writing, software
  12. # distributed under the License is distributed on an "AS IS" BASIS,
  13. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. # See the License for the specific language governing permissions and
  15. # limitations under the License.
  16. #
  18. # user data local directory path, please make sure the directory exists and have read write permissions
  19. data.basedir.path=/tmp/dolphinscheduler
  21. # resource storage type: HDFS, S3, NONE
  22. resource.storage.type=HDFS
  24. # resource store on HDFS/S3 path, resource file will store to this hadoop hdfs path, self configuration,
  25. # please make sure the directory exists on hdfs and have read write permissions. "/dolphinscheduler" is recommended
  26. resource.upload.path=/tmp/dolphinscheduler
  28. # whether to startup kerberos
  29. hadoop.security.authentication.startup.state=false
  31. # java.security.krb5.conf path
  32. java.security.krb5.conf.path=/opt/krb5.conf
  34. # login user from keytab username
  35. login.user.keytab.username=hdfs-mycluster@ESZ.COM
  37. # login user from keytab path
  38. login.user.keytab.path=/opt/hdfs.headless.keytab
  40. # kerberos expire time, the unit is hour
  41. kerberos.expire.time=2
  42. # resource view suffixs
  43. #resource.view.suffixs=txt,log,sh,bat,conf,cfg,py,java,sql,xml,hql,properties,json,yml,yaml,ini,js
  44. # if resource.storage.type=HDFS, the user must have the permission to create directories under the HDFS root path
  45. hdfs.root.user=root
  46. # if resource.storage.type=S3, the value like: s3a://dolphinscheduler;
  47. # if resource.storage.type=HDFS and namenode HA is enabled, you need to copy core-site.xml and hdfs-site.xml to conf dir
  48. fs.defaultFS=hdfs://localhost:8020
  49. aws.access.key.id=minioadmin
  50. aws.secret.access.key=minioadmin
  51. aws.region=us-east-1
  52. aws.endpoint=http://localhost:9000
  53. # resourcemanager port, the default value is 8088 if not specified
  54. resource.manager.httpaddress.port=8088
  55. # if resourcemanager HA is enabled, please set the HA IPs; if resourcemanager is single, keep this value empty
  56. yarn.resourcemanager.ha.rm.ids=192.168.xx.xx,192.168.xx.xx
  57. # if resourcemanager HA is enabled or not use resourcemanager, please keep the default value;
  58. # If resourcemanager is single, you only need to replace ds1 to actual resourcemanager hostname
  59. yarn.application.status.address=http://localhost:%s/ds/v1/cluster/apps/%s
  60. # job history status url when application number threshold is reached(default 10000, maybe it was set to 1000)
  61. yarn.job.history.status.address=http://localhost:19888/ds/v1/history/mapreduce/jobs/%s
  63. # datasource encryption enable
  64. datasource.encryption.enable=false
  66. # datasource encryption salt
  67. datasource.encryption.salt=!@#$%^&*
  69. # data quality option
  70. data-quality.jar.name=dolphinscheduler-data-quality-dev-SNAPSHOT.jar
  72. #data-quality.error.output.path=/tmp/data-quality-error-data
  74. # Network IP gets priority, default inner outer
  76. # Whether hive SQL is executed in the same session
  77. support.hive.oneSession=false
  79. # use sudo or not, if set true, executing user is tenant user and deploy user needs sudo permissions;
  80. # if set false, executing user is the deploy user and doesn't need sudo permissions
  81. sudo.enable=true
  83. # network interface preferred like eth0, default: empty
  84. #dolphin.scheduler.network.interface.preferred=
  86. # network IP gets priority, default: inner outer
  87. #dolphin.scheduler.network.priority.strategy=default
  89. # system env path
  90. #dolphinscheduler.env.path=env/dolphinscheduler_env.sh
  92. # development state
  93. development.state=false
  95. # rpc port
  96. alert.rpc.port=50052

注意：

  • 如果只配置了 api-server/conf/common.properties 的文件，则只是开启了资源上传的操作，并不能满足正常使用。如果想要在工作流中执行相关文件则需要额外配置 worker-server/conf/common.properties。
  • 如果用到资源上传的功能，那么安装部署中，部署用户需要有这部分的操作权限。
  • 如果 Hadoop 集群的 NameNode 配置了 HA 的话，需要开启 HDFS 类型的资源上传，同时需要将 Hadoop 集群下的 core-site.xml 和 hdfs-site.xml 复制到 /opt/dolphinscheduler/conf，非 NameNode HA 跳过次步骤。