Terraform Oci MCP Ep C Lb Waf

Oracle云基础架构（OCI）负载均衡器平台模块

此Terraform模块创建并管理Oracle Cloud Infrastructure（OCI）负载平衡器及其所有相关资源，包括后端集、侦听器、证书、路径路由集、规则集和主机名。

特性

• 完整的负载均衡器管理：使用灵活的形状选项创建和配置OCI负载均衡器
• 后端套件：支持具有不同负载平衡策略的多个后端集
• SSL/TLS支持：完整的SSL证书管理和HTTPS侦听器
• 健康检查：后端服务器的可配置健康检查
• 路径路由：支持到不同后端集的基于路径的路由
• 规则集：具有自定义规则的高级交通管理
• 主机名管理：支持多站点托管的虚拟主机名
• 安全组：网络安全组集成
• 灵活的形状：支持固定和灵活的负载平衡器形状
• 私有的/公共的：支持私有和公共负载平衡器

用法

基本HTTP负载平衡器

module "load_balancer" {
  source = "path/to/this/module"

  compartment_id = "ocid1.compartment.oc1..example"
  display_name   = "web-app-lb"
  shape          = "flexible"
  subnet_ids     = ["ocid1.subnet.oc1..example1", "ocid1.subnet.oc1..example2"]

  shape_details = {
    minimum_bandwidth_in_mbps = 10
    maximum_bandwidth_in_mbps = 100
  }

  backend_sets = {
    "web-backend" = {
      policy = "ROUND_ROBIN"
      backends = [
        {
          name       = "web-server-1"
          ip_address = "10.0.1.10"
          port       = 80
          weight     = 1
        },
        {
          name       = "web-server-2"
          ip_address = "10.0.1.11"
          port       = 80
          weight     = 1
        }
      ]
      health_checker = {
        protocol            = "HTTP"
        interval_ms         = 10000
        port                = 80
        response_body_regex = ".*"
        retries             = 3
        return_code         = 200
        timeout_in_millis   = 3000
        url_path            = "/health"
      }
    }
  }

  listeners = {
    "http-80" = {
      default_backend_set_name = "web-backend"
      port                     = 80
      protocol                 = "HTTP"
    }
  }

  freeform_tags = {
    Environment = "production"
    Application = "web-app"
  }
}

带SSL终止的HTTPS负载均衡器

module "https_load_balancer" {
  source = "path/to/this/module"

  compartment_id = "ocid1.compartment.oc1..example"
  display_name   = "secure-web-lb"
  shape          = "flexible"
  subnet_ids     = ["ocid1.subnet.oc1..example1", "ocid1.subnet.oc1..example2"]

  shape_details = {
    minimum_bandwidth_in_mbps = 10
    maximum_bandwidth_in_mbps = 400
  }

  certificates = {
    "ssl-cert" = {
      private_key        = file("path/to/private-key.pem")
      public_certificate = file("path/to/certificate.pem")
      ca_certificate     = file("path/to/ca-bundle.pem")
    }
  }

  backend_sets = {
    "secure-backend" = {
      policy = "ROUND_ROBIN"
      backends = [
        {
          name       = "app-server-1"
          ip_address = "10.0.1.20"
          port       = 8080
          weight     = 1
        }
      ]
      health_checker = {
        protocol            = "HTTP"
        interval_ms         = 10000
        port                = 8080
        url_path            = "/actuator/health"
        return_code         = 200
      }
    }
  }

  listeners = {
    "https-443" = {
      default_backend_set_name = "secure-backend"
      port                     = 443
      protocol                 = "HTTP"
      ssl_configuration = {
        certificate_name        = "ssl-cert"
        verify_peer_certificate = false
        protocols              = ["TLSv1.2", "TLSv1.3"]
      }
    }
  }
}

专用负载平衡器

module "private_load_balancer" {
  source = "path/to/this/module"

  compartment_id = "ocid1.compartment.oc1..example"
  display_name   = "internal-api-lb"
  shape          = "flexible"
  subnet_ids     = ["ocid1.subnet.oc1..private-subnet"]
  is_private     = true

  network_security_group_ids = ["ocid1.networksecuritygroup.oc1..example"]

  shape_details = {
    minimum_bandwidth_in_mbps = 10
    maximum_bandwidth_in_mbps = 100
  }

  backend_sets = {
    "api-backend" = {
      policy = "LEAST_CONNECTIONS"
      backends = [
        {
          name       = "api-server-1"
          ip_address = "10.0.2.10"
          port       = 8080
        },
        {
          name       = "api-server-2"
          ip_address = "10.0.2.11"
          port       = 8080
        }
      ]
    }
  }

  listeners = {
    "http-8080" = {
      default_backend_set_name = "api-backend"
      port                     = 8080
      protocol                 = "HTTP"
    }
  }
}

例子

这 examples/ 目录包含完整的工作示例：

• simple-load-balancer/：基本HTTP负载平衡器设置
• https-load-balancer/：具有SSL终止和重定向规则的HTTPS负载平衡器

需求

提供商

资源

输入

输出

负载平衡器形状

固定形状

• 10Mbps：10 Mbps
• 100Mbps：100 Mbps
• 400Mbps：400 Mbps
• 8000Mbps：8000 Mbps

灵活的形状

• flexible：可配置带宽（与 shape_details)

负载平衡策略

• ROUND_ROBIN：在后端服务器上均匀分配请求
• LEAST_CONNECTIONS：路由到活动连接最少的服务器
• IP_HASH：基于客户端IP哈希的路由

健康检查协议

• HTTP：HTTP健康检查
• HTTPS：HTTPS健康检查
• TCP：TCP连接健康检查

SSL/TLS配置

该模块支持全面的SSL/TLS配置：

• 使用私钥和证书链进行证书管理
• 可配置的SSL协议（TLSv1.2、TLSv1.3）
• 自定义密码套件
• 对等证书验证选项
• 密码选择的服务器顺序偏好

高级功能

基于路径的路由

根据URL路径将流量路由到不同的后端集：

path_route_sets = {
  "api-routes" = {
    path_routes = [
      {
        backend_set_name = "api-backend"
        path             = "/api/*"
        path_match_type = {
          match_type = "PREFIX_MATCH"
        }
      }
    ]
  }
}

规则集

创建自定义流量管理规则：

rule_sets = {
  "security-headers" = {
    items = [
      {
        action = "ADD_HTTP_REQUEST_HEADER"
        header = "X-Forwarded-Proto"
        value  = "https"
      }
    ]
  }
}

会话保持

配置会话粘性：

backend_sets = {
  "sticky-backend" = {
    policy = "ROUND_ROBIN"
    session_persistence_configuration = {
      cookie_name      = "JSESSIONID"
      disable_fallback = false
    }
  }
}

安全考虑

1. 网络安全组：使用NSG控制进出负载均衡器的流量
2. 专用负载平衡器：对内部流量使用专用负载平衡器
3. SSL/TLS：始终对生产工作负载使用HTTPS
4. 证书管理：定期轮换证书
5. 健康检查：配置适当的健康检查端点

监控和故障排除

• 使用OCI监控服务跟踪负载均衡器指标
• 在OCI控制台中检查后端服务器运行状况
• 监控访问日志中的流量模式和错误
• 设置健康检查失败的警报

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

此模块在MIT许可证下发布。有关详细信息，请参阅LICENSE文件。

支持

对于问题和疑问：

1. 检查 示例 目录
2. 查看OCI负载均衡器文档
3. 在此存储库中打开问题