知識庫 / DevOps RSS 訂閱

@SpringBootApplication
@EnableDiscoveryClient
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@RestController
public class ClientController {
    @Autowired
    private DiscoveryClient discoveryClient;
}

5. ConfigMaps

通常，微服務需要某種配置管理。例如，在 Spring Cloud 應用程序中，我們會使用 Spring Cloud Config Server。

但是，我們可以通過使用 ConfigMaps（由 Kubernetes 提供）來實現，前提是我們僅打算將其用於非敏感、未加密的信息。

如果我們要共享的信息敏感，則應選擇使用 Secrets。

在我們的示例中，我們正在將 ConfigMaps 用於 client-service Spring Boot 應用程序。讓我們創建一個 client-config.yaml 文件來定義 client-service 的 ConfigMap：

apiVersion: v1 by d
kind: ConfigMap
metadata:
  name: client-service
data:
  application.properties: |-
    bean.message=Testing reload! Message from backend is: %s <br/> Services : %s

配置映射（ConfigMap）的名稱應與應用程序的名稱相匹配，如我們在“application.properties”文件中所指定的那樣。在這種情況下，它為client-service。接下來，我們需要在 Kubernetes 上創建 client-service 的配置映射：

kubectl create -f client-config.yaml

現在，讓我們創建一個配置類 ClientConfig，並使用 @Configuration 和 @ConfigurationProperties 註解，並注入到 ClientController 中：

@Configuration
@ConfigurationProperties(prefix = "bean")
public class ClientConfig {

    private String message = "Message from backend is: %s <br/> Services : %s";

    // getters and setters
}

@RestController
public class ClientController {

    @Autowired
    private ClientConfig config;

    @GetMapping
    public String load() {
        return String.format(config.getMessage(), "", "");
    }
}

如果未指定 ConfigMap，我們應該期望看到默認消息，該消息在類中設置。但是，當我們創建 ConfigMap 時，該默認消息會被該屬性覆蓋。

此外，每次我們決定更新 ConfigMap 時，頁面上的消息也會相應地更改：

kubectl edit configmap client-service

6. 密鑰（Secrets）

讓我們通過分析 MongoDB 連接設置的規範，來了解 密鑰（Secrets） 的工作原理。我們將會在 Kubernetes 上創建環境變量，這些環境變量隨後會被注入到 Spring Boot 應用程序中。

6.1. 創建密鑰

第一步是創建名為 secret.yaml 的文件，其中編碼了 username 和 password，並使用 Base 64 編碼。

apiVersion: v1
kind: Secret
metadata:
  name: db-secret
data:
  username: dXNlcg==
  password: cDQ1NXcwcmQ=

讓我們在 Kubernetes 集羣上應用 Secret 配置：

kubectl apply -f secret.yaml

6.2. 創建 MongoDB 服務

現在，我們應該創建 MongoDB 服務以及部署文件 travel-agency-deployment.yaml。 尤其是在部署部分，我們將使用我們之前定義的 Secret username 和 password：

apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: mongo
spec:
  replicas: 1
  template:
    metadata:
      labels:
        service: mongo
      name: mongodb-service
    spec:
      containers:
      - args:
        - mongod
        - --smallfiles
        image: mongo:latest
        name: mongo
        env:
          - name: MONGO_INITDB_ROOT_USERNAME
            valueFrom:
              secretKeyRef:
                name: db-secret
                key: username
          - name: MONGO_INITDB_ROOT_PASSWORD
            valueFrom:
              secretKeyRef:
                name: db-secret
                key: password

默認情況下，mongo:latest 鏡像將創建一個名為 username 和 password 的用户，並使用 admin 數據庫。

6.3. 在旅行社服務中設置 MongoDB

重要的是更新應用程序屬性以添加與數據庫相關的信息。雖然我們可以自由指定數據庫名稱 admin，但在這裏我們隱藏了最敏感的信息，例如 用户名 和 密碼。

spring.cloud.kubernetes.reload.enabled=true
spring.cloud.kubernetes.secrets.name=db-secret
spring.data.mongodb.host=mongodb-service
spring.data.mongodb.port=27017
spring.data.mongodb.database=admin
spring.data.mongodb.username=${MONGO_USERNAME}
spring.data.mongodb.password=${MONGO_PASSWORD}

現在，讓我們來查看我們的 travel-agency-deployment 屬性文件，以更新服務和部署信息，其中包含用於連接到 mongodb-service 的用户名和密碼。

以下是文件中與 MongoDB 連接相關的部分：

env:
  - name: MONGO_USERNAME
    valueFrom:
      secretKeyRef:
        name: db-secret
        key: username
  - name: MONGO_PASSWORD
    valueFrom:
      secretKeyRef:
        name: db-secret
        key: password

7. 與 Ribbon 進行通信

在微服務環境中，我們通常需要服務實例的 Pod 列表，以便進行負載均衡。這通過使用 Spring Cloud Kubernetes Ribbon 提供的機制來實現。該機制可以自動發現並訪問特定服務的所有端點，並且隨後它會將信息填充到 Ribbon 的 ServerList 中。

讓我們先在 client-service 的 pom.xml 文件中添加 spring-cloud-starter-kubernetes-ribbon 依賴項：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-kubernetes-ribbon</artifactId>
</dependency>

下一步是為我們的 client-service 應用程序添加註釋 @RibbonClient：

@RibbonClient(name = "travel-agency-service")

當端點列表被填充後，Kubernetes 客户端將搜索當前命名空間/項目註冊的端點，這些端點與使用 @RibbonClient 註解定義的服務名稱匹配。

還需要在應用程序屬性中啓用 Ribbon 客户端：

ribbon.http.client.enabled=true

8. 附加功能

This section details some of the additional features available within the system. These features are designed to enhance the user experience and provide greater flexibility in configuring the system to meet specific needs.

8.1. Real-time Collaboration

The system supports real-time collaboration, allowing multiple users to work on the same document simultaneously. Changes made by one user are instantly reflected for all other users. This feature is facilitated by WebSocket technology and utilizes a shared document model.

8.2. Advanced Search

The advanced search functionality allows users to quickly locate specific content within the system. Users can filter results by keyword, date, author, and other criteria. The search index is built using Elasticsearch for optimal performance.

8.3. Customizable Templates

A library of customizable templates is provided to streamline the creation of new documents. Users can modify existing templates or create their own custom templates to suit their specific requirements. Template definitions are stored in JSON format.

{
  "name": "Default Document Template",
  "fields": [
    {
      "name": "Title",
      "type": "text"
    },
    {
      "name": "Content",
      "type": "textarea"
    }
  ]
}

8.1. Hystrix

Hystrix 幫助構建容錯和彈性應用。其主要目標是快速失敗和快速恢復。

@HystrixCommand(fallbackMethod = "getFallbackName", commandProperties = { 
    @HystrixProperty(name = "execution.isolation.thread.timeoutInMilliseconds", value = "1000") })
public String getDeals() {
    return this.restTemplate.getForObject("http://travel-agency-service:8080/deals", String.class);
}

private String getFallbackName() {
    return "Fallback";
}