Feature: Add instance metadata spi for registration (#324)

CHANGELOG.md

@@ -12,3 +12,4 @@
 - [fix: 将blocking call改为non-blocking call](https://github.com/Tencent/spring-cloud-tencent/pull/309)
 - [fix:solve the chaos code problem on rejectTips](https://github.com/Tencent/spring-cloud-tencent/pull/283)
 - [Fix config file format misspell](https://github.com/Tencent/spring-cloud-tencent/pull/321)
+- [Feature: Add instance metadata spi for registration](https://github.com/Tencent/spring-cloud-tencent/pull/324)

spring-cloud-starter-tencent-polaris-discovery/src/main/java/com/tencent/cloud/polaris/registry/PolarisRegistration.java

@@ -19,12 +19,14 @@
 package com.tencent.cloud.polaris.registry;
 
 import java.net.URI;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
 
 import com.tencent.cloud.common.metadata.StaticMetadataManager;
 import com.tencent.cloud.polaris.DiscoveryPropertiesAutoConfiguration;
 import com.tencent.cloud.polaris.PolarisDiscoveryProperties;
+import com.tencent.cloud.polaris.context.spi.InstanceMetadataProvider;
 import com.tencent.polaris.client.api.SDKContext;
 import org.apache.commons.lang.StringUtils;
 
@@ -40,6 +42,9 @@ import org.springframework.util.CollectionUtils;
  */
 public class PolarisRegistration implements Registration, ServiceInstance {
 
+	private final static String METADATA_KEY_IP = "internal-ip";
+	private final static String METADATA_KEY_ADDRESS = "internal-address";
+
 	private final DiscoveryPropertiesAutoConfiguration discoveryPropertiesAutoConfiguration;
 
 	private final PolarisDiscoveryProperties polarisDiscoveryProperties;
@@ -48,14 +53,24 @@ public class PolarisRegistration implements Registration, ServiceInstance {
 
 	private final StaticMetadataManager staticMetadataManager;
 
+	private final InstanceMetadataProvider instanceMetadataProvider;
+
 	private Map<String, String> metadata;
 
-	public PolarisRegistration(DiscoveryPropertiesAutoConfiguration discoveryPropertiesAutoConfiguration,
+	private final String host;
-			PolarisDiscoveryProperties polarisDiscoveryProperties, SDKContext context, StaticMetadataManager staticMetadataManager) {
+
+	public PolarisRegistration(
+			DiscoveryPropertiesAutoConfiguration discoveryPropertiesAutoConfiguration,
+			PolarisDiscoveryProperties polarisDiscoveryProperties, SDKContext context,
+			StaticMetadataManager staticMetadataManager,
+			InstanceMetadataProvider instanceMetadataProvider) {
 		this.discoveryPropertiesAutoConfiguration = discoveryPropertiesAutoConfiguration;
 		this.polarisDiscoveryProperties = polarisDiscoveryProperties;
 		this.polarisContext = context;
 		this.staticMetadataManager = staticMetadataManager;
+		this.instanceMetadataProvider = instanceMetadataProvider;
+
+		host = polarisContext.getConfig().getGlobal().getAPI().getBindIP();
 	}
 
 	@Override
@@ -65,7 +80,7 @@ public class PolarisRegistration implements Registration, ServiceInstance {
 
 	@Override
 	public String getHost() {
-		return polarisContext.getConfig().getGlobal().getAPI().getBindIP();
+		return host;
 	}
 
 	@Override
@@ -90,10 +105,35 @@ public class PolarisRegistration implements Registration, ServiceInstance {
 	@Override
 	public Map<String, String> getMetadata() {
 		if (CollectionUtils.isEmpty(metadata)) {
-			metadata = new HashMap<>();
+			Map<String, String> instanceMetadata = new HashMap<>();
-			metadata.putAll(staticMetadataManager.getMergedStaticMetadata());
+
+			// put internal metadata
+			instanceMetadata.put(METADATA_KEY_IP, host);
+			instanceMetadata.put(METADATA_KEY_ADDRESS, host + ":" + polarisDiscoveryProperties.getPort());
+
+			instanceMetadata.putAll(staticMetadataManager.getMergedStaticMetadata());
+
 			// location info will be putted both in metadata and instance's field
-			metadata.putAll(staticMetadataManager.getLocationMetadata());
+			instanceMetadata.putAll(staticMetadataManager.getLocationMetadata());
+
+			// custom metadata from spi
+			if (instanceMetadataProvider != null) {
+				if (StringUtils.isNotBlank(instanceMetadataProvider.getRegion())) {
+					instanceMetadata.put(StaticMetadataManager.LOCATION_KEY_ZONE, instanceMetadataProvider.getRegion());
+				}
+				if (StringUtils.isNotBlank(instanceMetadataProvider.getZone())) {
+					instanceMetadata.put(StaticMetadataManager.LOCATION_KEY_ZONE, instanceMetadataProvider.getZone());
+				}
+				if (StringUtils.isNotBlank(instanceMetadataProvider.getCampus())) {
+					instanceMetadata.put(StaticMetadataManager.LOCATION_KEY_ZONE, instanceMetadataProvider.getCampus());
+				}
+
+				if (!CollectionUtils.isEmpty(instanceMetadataProvider.getMetadata())) {
+					instanceMetadata.putAll(instanceMetadataProvider.getMetadata());
+				}
+			}
+
+			this.metadata = Collections.unmodifiableMap(instanceMetadata);
 		}
 		return metadata;
 	}

spring-cloud-starter-tencent-polaris-discovery/src/main/java/com/tencent/cloud/polaris/registry/PolarisServiceRegistryAutoConfiguration.java

@@ -21,6 +21,7 @@ package com.tencent.cloud.polaris.registry;
 import com.tencent.cloud.common.metadata.StaticMetadataManager;
 import com.tencent.cloud.polaris.DiscoveryPropertiesAutoConfiguration;
 import com.tencent.cloud.polaris.PolarisDiscoveryProperties;
+import com.tencent.cloud.polaris.context.spi.InstanceMetadataProvider;
 import com.tencent.cloud.polaris.discovery.PolarisDiscoveryAutoConfiguration;
 import com.tencent.cloud.polaris.discovery.PolarisDiscoveryHandler;
 import com.tencent.polaris.client.api.SDKContext;
@@ -34,6 +35,7 @@ import org.springframework.cloud.client.serviceregistry.AutoServiceRegistrationC
 import org.springframework.cloud.client.serviceregistry.AutoServiceRegistrationProperties;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.lang.Nullable;
 
 /**
  * Autoconfiguration of service registry of Polaris.
@@ -60,9 +62,9 @@ public class PolarisServiceRegistryAutoConfiguration {
 	public PolarisRegistration polarisRegistration(
 			DiscoveryPropertiesAutoConfiguration discoveryPropertiesAutoConfiguration,
 			PolarisDiscoveryProperties polarisDiscoveryProperties, SDKContext context,
-			StaticMetadataManager staticMetadataManager) {
+			StaticMetadataManager staticMetadataManager, @Nullable InstanceMetadataProvider instanceMetadataProvider) {
 		return new PolarisRegistration(discoveryPropertiesAutoConfiguration,
-				polarisDiscoveryProperties, context, staticMetadataManager);
+				polarisDiscoveryProperties, context, staticMetadataManager, instanceMetadataProvider);
 	}
 
 	@Bean

spring-cloud-starter-tencent-polaris-discovery/src/test/java/com/tencent/cloud/polaris/registry/PolarisRegistrationTest.java

@@ -78,7 +78,7 @@ public class PolarisRegistrationTest {
 		doReturn(Collections.singletonMap("key2", "value2")).when(staticMetadataManager).getLocationMetadata();
 
 		polarisRegistration = new PolarisRegistration(
-				discoveryPropertiesAutoConfiguration, polarisDiscoveryProperties, polarisContext, staticMetadataManager);
+				discoveryPropertiesAutoConfiguration, polarisDiscoveryProperties, polarisContext, staticMetadataManager, null);
 	}
 
 	@Test
@@ -111,7 +111,7 @@ public class PolarisRegistrationTest {
 		Map<String, String> metadata = polarisRegistration.getMetadata();
 		assertThat(metadata).isNotNull();
 		assertThat(metadata).isNotEmpty();
-		assertThat(metadata.size()).isEqualTo(2);
+		assertThat(metadata.size()).isEqualTo(4);
 		assertThat(metadata.get("key1")).isEqualTo("value1");
 		assertThat(metadata.get("key2")).isEqualTo("value2");
 	}

spring-cloud-tencent-commons/src/main/java/com/tencent/cloud/common/metadata/StaticMetadataManager.java

@@ -43,9 +43,18 @@ public class StaticMetadataManager {
 	private static final String ENV_METADATA_REGION = "SCT_METADATA_REGION";
 	private static final String ENV_METADATA_CAMPUS = "SCT_METADATA_CAMPUS";
 
-	private static final String LOCATION_KEY_REGION = "region";
+	/**
-	private static final String LOCATION_KEY_ZONE = "zone";
+	 * the metadata key of region.
-	private static final String LOCATION_KEY_CAMPUS = "campus";
+	 */
+	public static final String LOCATION_KEY_REGION = "region";
+	/**
+	 * the metadata key of zone.
+	 */
+	public static final String LOCATION_KEY_ZONE = "zone";
+	/**
+	 * the metadata key of campus/datacenter.
+	 */
+	public static final String LOCATION_KEY_CAMPUS = "campus";
 
 	private Map<String, String> envMetadata;
 	private Map<String, String> envTransitiveMetadata;

spring-cloud-tencent-examples/polaris-discovery-example/discovery-callee-service/src/main/java/com/tencent/cloud/polaris/discovery/service/callee/CustomMetadata.java

@@ -0,0 +1,56 @@
+/*
+ * Tencent is pleased to support the open source community by making Spring Cloud Tencent available.
+ *
+ * Copyright (C) 2019 THL A29 Limited, a Tencent company. All rights reserved.
+ *
+ * Licensed under the BSD 3-Clause License (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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 com.tencent.cloud.polaris.discovery.service.callee;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import com.tencent.cloud.polaris.context.spi.InstanceMetadataProvider;
+
+import org.springframework.stereotype.Component;
+
+/**
+ * custom metadata for instance.
+ *@author lepdou 2022-06-16
+ */
+@Component
+public class CustomMetadata implements InstanceMetadataProvider {
+
+	@Override
+	public Map<String, String> getMetadata() {
+		Map<String, String> metadata = new HashMap<>();
+		metadata.put("k1", "v1");
+		return metadata;
+	}
+
+	@Override
+	public String getRegion() {
+		return "shanghai";
+	}
+
+	@Override
+	public String getZone() {
+		return null;
+	}
+
+	@Override
+	public String getCampus() {
+		return null;
+	}
+}

spring-cloud-tencent-polaris-context/src/main/java/com/tencent/cloud/polaris/context/spi/InstanceMetadataProvider.java

@@ -0,0 +1,55 @@
+/*
+ * Tencent is pleased to support the open source community by making Spring Cloud Tencent available.
+ *
+ * Copyright (C) 2019 THL A29 Limited, a Tencent company. All rights reserved.
+ *
+ * Licensed under the BSD 3-Clause License (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://opensource.org/licenses/BSD-3-Clause
+ *
+ * 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 com.tencent.cloud.polaris.context.spi;
+
+import java.util.Map;
+
+/**
+ *
+ * Instance's custom metadata, metadata will be register to polaris server.
+ * @author lepdou 2022-06-16
+ */
+public interface InstanceMetadataProvider {
+
+	/**
+	 * @return the metadata of instance.
+	 */
+	Map<String, String> getMetadata();
+
+	/**
+	 * The region of current instance.
+	 *
+	 * @return the region info.
+	 */
+	String getRegion();
+
+	/**
+	 * The zone of current instance.
+	 *
+	 * @return the zone info.
+	 */
+	String getZone();
+
+	/**
+	 * The campus/datacenter of current instance.
+	 *
+	 * @return the campus or datacenter info.
+	 */
+	String getCampus();
+}