| /* |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package org.apache.flink.configuration; |
| |
| import org.apache.flink.annotation.Internal; |
| import org.apache.flink.annotation.VisibleForTesting; |
| import org.apache.flink.util.Preconditions; |
| |
| import org.slf4j.Logger; |
| import org.slf4j.LoggerFactory; |
| |
| import javax.annotation.Nullable; |
| |
| import java.io.BufferedReader; |
| import java.io.File; |
| import java.io.FileInputStream; |
| import java.io.IOException; |
| import java.io.InputStreamReader; |
| |
| /** |
| * Global configuration object for Flink. Similar to Java properties configuration |
| * objects it includes key-value pairs which represent the framework's configuration. |
| */ |
| @Internal |
| public final class GlobalConfiguration { |
| |
| private static final Logger LOG = LoggerFactory.getLogger(GlobalConfiguration.class); |
| |
| public static final String FLINK_CONF_FILENAME = "flink-conf.yaml"; |
| |
| // the keys whose values should be hidden |
| private static final String[] SENSITIVE_KEYS = new String[] {"password", "secret"}; |
| |
| // the hidden content to be displayed |
| public static final String HIDDEN_CONTENT = "******"; |
| |
| // -------------------------------------------------------------------------------------------- |
| |
| private GlobalConfiguration() {} |
| |
| // -------------------------------------------------------------------------------------------- |
| |
| /** |
| * Loads the global configuration from the environment. Fails if an error occurs during loading. Returns an |
| * empty configuration object if the environment variable is not set. In production this variable is set but |
| * tests and local execution/debugging don't have this environment variable set. That's why we should fail |
| * if it is not set. |
| * @return Returns the Configuration |
| */ |
| public static Configuration loadConfiguration() { |
| final String configDir = System.getenv(ConfigConstants.ENV_FLINK_CONF_DIR); |
| if (configDir == null) { |
| return new Configuration(); |
| } |
| return loadConfiguration(configDir, null); |
| } |
| |
| /** |
| * Loads the configuration files from the specified directory. |
| * |
| * <p>YAML files are supported as configuration files. |
| * |
| * @param configDir |
| * the directory which contains the configuration files |
| */ |
| public static Configuration loadConfiguration(final String configDir) { |
| return loadConfiguration(configDir, null); |
| } |
| |
| /** |
| * Loads the configuration files from the specified directory. If the dynamic properties |
| * configuration is not null, then it is added to the loaded configuration. |
| * |
| * @param configDir directory to load the configuration from |
| * @param dynamicProperties configuration file containing the dynamic properties. Null if none. |
| * @return The configuration loaded from the given configuration directory |
| */ |
| public static Configuration loadConfiguration(final String configDir, @Nullable final Configuration dynamicProperties) { |
| |
| if (configDir == null) { |
| throw new IllegalArgumentException("Given configuration directory is null, cannot load configuration"); |
| } |
| |
| final File confDirFile = new File(configDir); |
| if (!(confDirFile.exists())) { |
| throw new IllegalConfigurationException( |
| "The given configuration directory name '" + configDir + |
| "' (" + confDirFile.getAbsolutePath() + ") does not describe an existing directory."); |
| } |
| |
| // get Flink yaml configuration file |
| final File yamlConfigFile = new File(confDirFile, FLINK_CONF_FILENAME); |
| |
| if (!yamlConfigFile.exists()) { |
| throw new IllegalConfigurationException( |
| "The Flink config file '" + yamlConfigFile + |
| "' (" + confDirFile.getAbsolutePath() + ") does not exist."); |
| } |
| |
| Configuration configuration = loadYAMLResource(yamlConfigFile); |
| |
| if (dynamicProperties != null) { |
| configuration.addAll(dynamicProperties); |
| } |
| |
| return configuration; |
| } |
| |
| /** |
| * Loads the global configuration and adds the given dynamic properties |
| * configuration. |
| * |
| * @param dynamicProperties The given dynamic properties |
| * @return Returns the loaded global configuration with dynamic properties |
| */ |
| public static Configuration loadConfigurationWithDynamicProperties(Configuration dynamicProperties) { |
| final String configDir = System.getenv(ConfigConstants.ENV_FLINK_CONF_DIR); |
| if (configDir == null) { |
| return new Configuration(dynamicProperties); |
| } |
| |
| return loadConfiguration(configDir, dynamicProperties); |
| } |
| |
| /** |
| * Loads a YAML-file of key-value pairs. |
| * |
| * <p>Colon and whitespace ": " separate key and value (one per line). The hash tag "#" starts a single-line comment. |
| * |
| * <p>Example: |
| * |
| * <pre> |
| * jobmanager.rpc.address: localhost # network address for communication with the job manager |
| * jobmanager.rpc.port : 6123 # network port to connect to for communication with the job manager |
| * taskmanager.rpc.port : 6122 # network port the task manager expects incoming IPC connections |
| * </pre> |
| * |
| * <p>This does not span the whole YAML specification, but only the *syntax* of simple YAML key-value pairs (see issue |
| * #113 on GitHub). If at any point in time, there is a need to go beyond simple key-value pairs syntax |
| * compatibility will allow to introduce a YAML parser library. |
| * |
| * @param file the YAML file to read from |
| * @see <a href="http://www.yaml.org/spec/1.2/spec.html">YAML 1.2 specification</a> |
| */ |
| @VisibleForTesting |
| public static Configuration loadYAMLResource(File file) { |
| final Configuration config = new Configuration(); |
| |
| try (BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(file)))){ |
| |
| String line; |
| int lineNo = 0; |
| while ((line = reader.readLine()) != null) { |
| lineNo++; |
| // 1. check for comments |
| String[] comments = line.split("#", 2); |
| String conf = comments[0].trim(); |
| |
| // 2. get key and value |
| if (conf.length() > 0) { |
| String[] kv = conf.split(": ", 2); |
| |
| // skip line with no valid key-value pair |
| if (kv.length == 1) { |
| LOG.warn("Error while trying to split key and value in configuration file " + file + ":" + lineNo + ": \"" + line + "\""); |
| continue; |
| } |
| |
| String key = kv[0].trim(); |
| String value = kv[1].trim(); |
| |
| // sanity check |
| if (key.length() == 0 || value.length() == 0) { |
| LOG.warn("Error after splitting key and value in configuration file " + file + ":" + lineNo + ": \"" + line + "\""); |
| continue; |
| } |
| |
| LOG.info("Loading configuration property: {}, {}", key, isSensitive(key) ? HIDDEN_CONTENT : value); |
| config.setString(key, value); |
| } |
| } |
| } catch (IOException e) { |
| throw new RuntimeException("Error parsing YAML configuration.", e); |
| } |
| |
| return config; |
| } |
| |
| /** |
| * Check whether the key is a hidden key. |
| * |
| * @param key the config key |
| */ |
| public static boolean isSensitive(String key) { |
| Preconditions.checkNotNull(key, "key is null"); |
| final String keyInLower = key.toLowerCase(); |
| for (String hideKey : SENSITIVE_KEYS) { |
| if (keyInLower.length() >= hideKey.length() |
| && keyInLower.contains(hideKey)) { |
| return true; |
| } |
| } |
| return false; |
| } |
| } |