| /* |
| * 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.brooklyn.entity.brooklynnode; |
| |
| import java.net.InetAddress; |
| import java.net.URI; |
| import java.util.List; |
| import java.util.Map; |
| |
| import org.apache.brooklyn.api.catalog.Catalog; |
| import org.apache.brooklyn.api.effector.Effector; |
| import org.apache.brooklyn.api.entity.ImplementedBy; |
| import org.apache.brooklyn.api.mgmt.ha.HighAvailabilityMode; |
| import org.apache.brooklyn.api.mgmt.ha.ManagementNodeState; |
| import org.apache.brooklyn.api.sensor.AttributeSensor; |
| import org.apache.brooklyn.config.ConfigKey; |
| import org.apache.brooklyn.core.BrooklynVersion; |
| import org.apache.brooklyn.core.config.ConfigKeys; |
| import org.apache.brooklyn.core.config.MapConfigKey; |
| import org.apache.brooklyn.core.effector.Effectors; |
| import org.apache.brooklyn.core.entity.BrooklynConfigKeys; |
| import org.apache.brooklyn.core.sensor.BasicAttributeSensor; |
| import org.apache.brooklyn.core.sensor.BasicAttributeSensorAndConfigKey; |
| import org.apache.brooklyn.core.sensor.PortAttributeSensorAndConfigKey; |
| import org.apache.brooklyn.core.sensor.Sensors; |
| import org.apache.brooklyn.core.sensor.BasicAttributeSensorAndConfigKey.StringAttributeSensorAndConfigKey; |
| import org.apache.brooklyn.entity.java.UsesJava; |
| import org.apache.brooklyn.entity.software.base.SoftwareProcess; |
| import org.apache.brooklyn.util.collections.MutableMap; |
| import org.apache.brooklyn.util.core.flags.SetFromFlag; |
| import org.apache.brooklyn.util.net.Networking; |
| import org.apache.brooklyn.util.ssh.BashCommands; |
| import org.apache.brooklyn.util.time.Duration; |
| |
| import com.google.common.annotations.VisibleForTesting; |
| import com.google.common.base.Function; |
| import com.google.common.base.Functions; |
| import com.google.common.collect.ImmutableList; |
| import com.google.common.collect.Lists; |
| import com.google.common.reflect.TypeToken; |
| |
| @Catalog(name="Brooklyn Node", description="Deploys a Brooklyn management server") |
| @ImplementedBy(BrooklynNodeImpl.class) |
| public interface BrooklynNode extends SoftwareProcess, UsesJava { |
| |
| @SuppressWarnings("serial") |
| @SetFromFlag("copyToRundir") |
| public static final BasicAttributeSensorAndConfigKey<Map<String,String>> COPY_TO_RUNDIR = new BasicAttributeSensorAndConfigKey<Map<String,String>>( |
| new TypeToken<Map<String,String>>() {}, "brooklynnode.copytorundir", "URLs of resources to be copied across to the server, giving the path they are to be copied to", MutableMap.<String,String>of()); |
| |
| @SetFromFlag("version") |
| public static final ConfigKey<String> SUGGESTED_VERSION = ConfigKeys.newConfigKeyWithDefault(BrooklynConfigKeys.SUGGESTED_VERSION, "0.8.1-SNAPSHOT"); // BROOKLYN_VERSION |
| |
| @SetFromFlag("distroUploadUrl") |
| public static final ConfigKey<String> DISTRO_UPLOAD_URL = ConfigKeys.newStringConfigKey( |
| "brooklynnode.distro.uploadurl", "URL for uploading the brooklyn distro (retrieved locally and pushed to remote install location. Takes precedence over downloadUrl, if non-null)", null); |
| |
| // Note that download URL only supports versions in org.apache.brooklyn, so not 0.6.0 and earlier |
| // (which used maven group io.brooklyn). Aled thinks we can live with that. |
| @SetFromFlag("downloadUrl") |
| BasicAttributeSensorAndConfigKey<String> DOWNLOAD_URL = new StringAttributeSensorAndConfigKey( |
| SoftwareProcess.DOWNLOAD_URL, |
| "<#if version?contains(\"SNAPSHOT\")>"+ |
| "https://repository.apache.org/service/local/artifact/maven/redirect?r=snapshots&g=org.apache.brooklyn&v=${version}&a=brooklyn-dist&c=dist&e=tar.gz" + |
| "<#else>"+ |
| "http://search.maven.org/remotecontent?filepath=org/apache/brooklyn/brooklyn-dist/${version}/brooklyn-dist-${version}-dist.tar.gz"+ |
| "</#if>"); |
| |
| @SetFromFlag("subpathInArchive") |
| ConfigKey<String> SUBPATH_IN_ARCHIVE = ConfigKeys.newStringConfigKey("brooklynnode.download.archive.subpath", |
| "Path to the main directory in the archive being supplied for installation; " |
| + "to use the root of an archive, specify '.'; " |
| + "default value taken based on download URL (e.g. 'name' for 'http://path/name.tgz' or 'http://path/name-dist.tgz') " |
| + "falling back to an appropriate value for brooklyn, " |
| + "e.g. 'brooklyn-"+BrooklynVersion.INSTANCE.getVersion()+"'", null); |
| |
| @SetFromFlag("managementUser") |
| ConfigKey<String> MANAGEMENT_USER = ConfigKeys.newConfigKey("brooklynnode.managementUser", |
| "The user for logging into the brooklyn web-console (also used for health-checks)", |
| "admin"); |
| |
| @SetFromFlag("managementPassword") |
| ConfigKey<String> MANAGEMENT_PASSWORD = |
| ConfigKeys.newStringConfigKey("brooklynnode.managementPassword", "Password for MANAGEMENT_USER", null); |
| |
| /** useful e.g. with {@link BashCommands#generateKeyInDotSshIdRsaIfNotThere() } */ |
| @SetFromFlag("extraCustomizationScript") |
| ConfigKey<String> EXTRA_CUSTOMIZATION_SCRIPT = ConfigKeys.newStringConfigKey("brooklynnode.customization.extraScript", |
| "Optional additional script commands to run as part of customization; this might e.g. ensure id_rsa is set up", |
| null); |
| |
| static enum ExistingFileBehaviour { |
| DO_NOT_USE, USE_EXISTING, OVERWRITE, FAIL |
| } |
| |
| @SetFromFlag("onExistingProperties") |
| ConfigKey<ExistingFileBehaviour> ON_EXISTING_PROPERTIES_FILE = ConfigKeys.newConfigKey(ExistingFileBehaviour.class, |
| "brooklynnode.properties.file.ifExists", |
| "What to do in the case where a global brooklyn.properties already exists", |
| ExistingFileBehaviour.FAIL); |
| |
| @SetFromFlag("launchCommand") |
| ConfigKey<String> LAUNCH_COMMAND = ConfigKeys.newStringConfigKey("brooklynnode.launch.command", |
| "Path to the script to launch Brooklyn / the app relative to the subpath in the archive, defaulting to 'bin/brooklyn'", |
| "bin/brooklyn"); |
| |
| @SetFromFlag("launchParameters") |
| ConfigKey<String> EXTRA_LAUNCH_PARAMETERS = ConfigKeys.newStringConfigKey("brooklynnode.launch.parameters.extra", |
| "Launch parameters passed on the CLI, in addition to 'launch' and parameters implied by other config keys (and placed afterwards on the command line)"); |
| |
| @SetFromFlag("launchCommandCreatesPidFile") |
| ConfigKey<Boolean> LAUNCH_COMMAND_CREATES_PID_FILE = ConfigKeys.newBooleanConfigKey("brooklynnode.launch.command.pid.updated", |
| "Whether the launch script creates/updates the PID file, if not the entity will do so, " |
| + "but note it will not necessarily kill sub-processes", |
| true); |
| |
| @SetFromFlag("app") |
| public static final BasicAttributeSensorAndConfigKey<String> APP = new BasicAttributeSensorAndConfigKey<String>( |
| String.class, "brooklynnode.app", "Application (fully qualified class name) to launch using the brooklyn CLI", null); |
| |
| @SetFromFlag("locations") |
| public static final BasicAttributeSensorAndConfigKey<String> LOCATIONS = new BasicAttributeSensorAndConfigKey<String>( |
| String.class, "brooklynnode.locations", "Locations to use when launching the app", null); |
| |
| /** |
| * Exposed just for testing; remote path is not passed into the launched brooklyn so this won't be used! |
| * This will likely change in a future version. |
| */ |
| @VisibleForTesting |
| @SetFromFlag("brooklynGlobalPropertiesRemotePath") |
| public static final ConfigKey<String> BROOKLYN_GLOBAL_PROPERTIES_REMOTE_PATH = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklynproperties.global.remotepath", |
| "Remote path for the global brooklyn.properties file to be uploaded", "${HOME}/.brooklyn/brooklyn.properties; "+ |
| "only useful for testing as this path will not be used on the remote system"); |
| |
| @SetFromFlag("brooklynGlobalPropertiesUri") |
| public static final ConfigKey<String> BROOKLYN_GLOBAL_PROPERTIES_URI = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklynproperties.global.uri", "URI for the global brooklyn properties file (uploaded to ~/.brooklyn/brooklyn.properties)", null); |
| |
| @SetFromFlag("brooklynGlobalPropertiesContents") |
| public static final ConfigKey<String> BROOKLYN_GLOBAL_PROPERTIES_CONTENTS = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklynproperties.global.contents", "Contents for the global brooklyn properties file (uploaded to ~/.brooklyn/brooklyn.properties)", null); |
| |
| @SetFromFlag("brooklynLocalPropertiesRemotePath") |
| public static final ConfigKey<String> BROOKLYN_LOCAL_PROPERTIES_REMOTE_PATH = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklynproperties.local.remotepath", "Remote path for the launch-specific brooklyn.properties file to be uploaded", "${driver.runDir}/brooklyn-local.properties"); |
| |
| @SetFromFlag("brooklynLocalPropertiesUri") |
| public static final ConfigKey<String> BROOKLYN_LOCAL_PROPERTIES_URI = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklynproperties.local.uri", "URI for the launch-specific brooklyn properties file", null); |
| |
| @SetFromFlag("brooklynLocalPropertiesContents") |
| public static final ConfigKey<String> BROOKLYN_LOCAL_PROPERTIES_CONTENTS = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklynproperties.local.contents", "Contents for the launch-specific brooklyn properties file", null); |
| |
| // For use in testing primarily |
| /** @deprecated since 0.7.0; TODO this should support BOM files */ |
| @Deprecated |
| @SetFromFlag("brooklynCatalogRemotePath") |
| public static final ConfigKey<String> BROOKLYN_CATALOG_REMOTE_PATH = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklyncatalog.remotepath", "Remote path for the brooklyn catalog.xml file to be uploaded", "${HOME}/.brooklyn/catalog.xml"); |
| |
| /** @deprecated since 0.7.0; TODO this should support BOM files */ |
| @Deprecated |
| @SetFromFlag("brooklynCatalogUri") |
| public static final ConfigKey<String> BROOKLYN_CATALOG_URI = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklyncatalog.uri", "URI for the brooklyn catalog.xml file (uploaded to ~/.brooklyn/catalog.xml)", null); |
| |
| /** @deprecated since 0.7.0; TODO this should support BOM files */ |
| @Deprecated |
| @SetFromFlag("brooklynCatalogContents") |
| public static final ConfigKey<String> BROOKLYN_CATALOG_CONTENTS = ConfigKeys.newStringConfigKey( |
| "brooklynnode.brooklyncatalog.contents", "Contents for the brooklyn catalog.xml file (uploaded to ~/.brooklyn/catalog.xml)", null); |
| |
| @SuppressWarnings({ "rawtypes", "unchecked" }) |
| @SetFromFlag("enabledHttpProtocols") |
| public static final BasicAttributeSensorAndConfigKey<List<String>> ENABLED_HTTP_PROTOCOLS = new BasicAttributeSensorAndConfigKey( |
| List.class, "brooklynnode.webconsole.enabledHttpProtocols", "List of enabled protocols (e.g. http, https)", ImmutableList.of("http")); |
| |
| @SetFromFlag("httpPort") |
| public static final PortAttributeSensorAndConfigKey HTTP_PORT = new PortAttributeSensorAndConfigKey( |
| "brooklynnode.webconsole.httpPort", "HTTP Port for the brooklyn web-console", "8081+"); |
| |
| @SetFromFlag("httpsPort") |
| public static final PortAttributeSensorAndConfigKey HTTPS_PORT = new PortAttributeSensorAndConfigKey( |
| "brooklynnode.webconsole.httpsPort", "HTTPS Port for the brooklyn web-console", "8443+"); |
| |
| @SetFromFlag("noWebConsoleSecurity") |
| public static final BasicAttributeSensorAndConfigKey<Boolean> NO_WEB_CONSOLE_AUTHENTICATION = new BasicAttributeSensorAndConfigKey<Boolean>( |
| Boolean.class, "brooklynnode.webconsole.nosecurity", "Whether to start the web console with no security", false); |
| |
| @SetFromFlag("bindAddress") |
| public static final BasicAttributeSensorAndConfigKey<InetAddress> WEB_CONSOLE_BIND_ADDRESS = new BasicAttributeSensorAndConfigKey<InetAddress>( |
| InetAddress.class, "brooklynnode.webconsole.address.bind", "Specifies the IP address of the NIC to bind the Brooklyn Management Console to (default 0.0.0.0)", Networking.ANY_NIC); |
| |
| @SetFromFlag("publicAddress") |
| public static final BasicAttributeSensorAndConfigKey<InetAddress> WEB_CONSOLE_PUBLIC_ADDRESS = new BasicAttributeSensorAndConfigKey<InetAddress>( |
| InetAddress.class, "brooklynnode.webconsole.address.public", "Specifies the public IP address or hostname for the Brooklyn Management Console"); |
| |
| public static final AttributeSensor<Boolean> WEB_CONSOLE_ACCESSIBLE = Sensors.newBooleanSensor( |
| "brooklynnode.webconsole.up", "Whether the web console is responding normally"); |
| |
| @SuppressWarnings({ "rawtypes", "unchecked" }) |
| @SetFromFlag("classpath") |
| public static final BasicAttributeSensorAndConfigKey<List<String>> CLASSPATH = new BasicAttributeSensorAndConfigKey( |
| List.class, "brooklynnode.classpath", "classpath to use, as list of URL entries", Lists.newArrayList()); |
| |
| @SuppressWarnings({ "rawtypes", "unchecked" }) |
| @SetFromFlag("portMapper") |
| public static final ConfigKey<Function<? super Integer, ? extends Integer>> PORT_MAPPER = (ConfigKey) ConfigKeys.newConfigKey(Function.class, |
| "brooklynnode.webconsole.portMapper", "Function for mapping private to public ports, for use in inferring the brooklyn URI", Functions.<Integer>identity()); |
| |
| public static final AttributeSensor<URI> WEB_CONSOLE_URI = new BasicAttributeSensor<URI>( |
| URI.class, "brooklynnode.webconsole.url", "URL of the brooklyn web-console"); |
| |
| public static final AttributeSensor<ManagementNodeState> MANAGEMENT_NODE_STATE = new BasicAttributeSensor<ManagementNodeState>( |
| ManagementNodeState.class, "brooklynnode.ha.state", "High-availability state of the management node (MASTER, HOT_STANDBY, etc)"); |
| |
| public static final ConfigKey<Duration> POLL_PERIOD = ConfigKeys.newConfigKey(Duration.class, "brooklynnode.poll_period", |
| "Frequency to poll for client sensors", Duration.seconds(2)); |
| |
| public interface DeployBlueprintEffector { |
| ConfigKey<Map<String,Object>> BLUEPRINT_CAMP_PLAN = new MapConfigKey<Object>(Object.class, "blueprintPlan", |
| "CAMP plan for the blueprint to be deployed; currently only supports Java map or JSON string (not yet YAML)"); |
| ConfigKey<String> BLUEPRINT_TYPE = ConfigKeys.newStringConfigKey("blueprintType"); |
| ConfigKey<Map<String,Object>> BLUEPRINT_CONFIG = new MapConfigKey<Object>(Object.class, "blueprintConfig"); |
| Effector<String> DEPLOY_BLUEPRINT = Effectors.effector(String.class, "deployBlueprint") |
| .description("Deploy a blueprint, either given a plan (as Java map or JSON string for a map), or given URL and optional config") |
| .parameter(BLUEPRINT_TYPE) |
| .parameter(BLUEPRINT_CONFIG) |
| .parameter(BLUEPRINT_CAMP_PLAN) |
| .buildAbstract(); |
| } |
| |
| public static final Effector<String> DEPLOY_BLUEPRINT = DeployBlueprintEffector.DEPLOY_BLUEPRINT; |
| |
| public interface ShutdownEffector { |
| ConfigKey<Boolean> STOP_APPS_FIRST = ConfigKeys.newBooleanConfigKey("stopAppsFirst", "Whether to stop apps before shutting down"); |
| ConfigKey<Boolean> FORCE_SHUTDOWN_ON_ERROR = ConfigKeys.newBooleanConfigKey("forceShutdownOnError", "Force shutdown if apps fail to stop or timeout"); |
| ConfigKey<Duration> SHUTDOWN_TIMEOUT = ConfigKeys.newConfigKey(Duration.class, "shutdownTimeout", "A maximum delay to wait for apps to gracefully stop before giving up or forcibly exiting"); |
| ConfigKey<Duration> REQUEST_TIMEOUT = ConfigKeys.newConfigKey(Duration.class, "requestTimeout", "Maximum time to block the request for the shutdown to finish, 0 to wait infinitely"); |
| ConfigKey<Duration> DELAY_FOR_HTTP_RETURN = ConfigKeys.newConfigKey(Duration.class, "delayForHttpReturn", "The delay before exiting the process, to permit the REST response to be returned"); |
| Effector<Void> SHUTDOWN = Effectors.effector(Void.class, "shutdown") |
| .description("Shutdown the remote brooklyn instance (stops via the REST API only; leaves any VM)") |
| .parameter(STOP_APPS_FIRST) |
| .parameter(FORCE_SHUTDOWN_ON_ERROR) |
| .parameter(SHUTDOWN_TIMEOUT) |
| .parameter(REQUEST_TIMEOUT) |
| .parameter(DELAY_FOR_HTTP_RETURN) |
| .buildAbstract(); |
| } |
| |
| public static final Effector<Void> SHUTDOWN = ShutdownEffector.SHUTDOWN; |
| |
| public interface StopNodeButLeaveAppsEffector { |
| ConfigKey<Duration> TIMEOUT = ConfigKeys.newConfigKey(Duration.class, "timeout", "How long to wait before giving up on stopping the node", Duration.ONE_HOUR); |
| Effector<Void> STOP_NODE_BUT_LEAVE_APPS = Effectors.effector(Void.class, "stopNodeButLeaveApps") |
| .description("Stop the Brooklyn process, and any VM created, and unmanage this entity; but if it was managing other applications, leave them running") |
| .parameter(TIMEOUT) |
| .buildAbstract(); |
| } |
| |
| public static final Effector<Void> STOP_NODE_BUT_LEAVE_APPS = StopNodeButLeaveAppsEffector.STOP_NODE_BUT_LEAVE_APPS; |
| |
| public interface StopNodeAndKillAppsEffector { |
| ConfigKey<Duration> TIMEOUT = ConfigKeys.newConfigKey(Duration.class, "timeout", "How long to wait before giving up on stopping the node", Duration.ONE_HOUR); |
| Effector<Void> STOP_NODE_AND_KILL_APPS = Effectors.effector(Void.class, "stopNodeAndKillApps") |
| .description("Stop all apps managed by the Brooklyn process, stop the process, and any VM created, and unmanage this entity") |
| .parameter(TIMEOUT) |
| .buildAbstract(); |
| } |
| |
| public static final Effector<Void> STOP_NODE_AND_KILL_APPS = StopNodeAndKillAppsEffector.STOP_NODE_AND_KILL_APPS; |
| |
| public interface SetHighAvailabilityPriorityEffector { |
| ConfigKey<Integer> PRIORITY = ConfigKeys.newIntegerConfigKey("priority", "HA priority"); |
| Effector<Integer> SET_HIGH_AVAILABILITY_PRIORITY = Effectors.effector(Integer.class, "setHighAvailabilityPriority") |
| .description("Set the HA priority on the node, returning the old priority") |
| .parameter(PRIORITY) |
| .buildAbstract(); |
| } |
| |
| public static final Effector<Integer> SET_HIGH_AVAILABILITY_PRIORITY = SetHighAvailabilityPriorityEffector.SET_HIGH_AVAILABILITY_PRIORITY; |
| |
| public interface SetHighAvailabilityModeEffector { |
| ConfigKey<HighAvailabilityMode> MODE = ConfigKeys.newConfigKey(HighAvailabilityMode.class, "mode", "HA mode"); |
| Effector<ManagementNodeState> SET_HIGH_AVAILABILITY_MODE = Effectors.effector(ManagementNodeState.class, "setHighAvailabilityMode") |
| .description("Set the HA mode on the node, returning the existing state") |
| .parameter(MODE) |
| .buildAbstract(); |
| } |
| |
| public static final Effector<ManagementNodeState> SET_HIGH_AVAILABILITY_MODE = SetHighAvailabilityModeEffector.SET_HIGH_AVAILABILITY_MODE; |
| |
| public EntityHttpClient http(); |
| } |