SteeltoeOSS 示例项目教程

项目介绍

SteeltoeOSS 是一个开源的 .NET 微服务框架，旨在帮助开发者构建云原生应用程序。它提供了与 Spring Cloud 类似的功能，包括服务发现、配置管理、断路器、负载均衡等。SteeltoeOSS 支持 .NET Core 和 .NET Framework，并且可以与各种云平台（如 Azure、Pivotal Cloud Foundry 等）无缝集成。

项目快速启动

环境准备

1. 安装 .NET Core SDK：确保你已经安装了 .NET Core SDK。你可以从 .NET 官方网站 下载并安装。

2. 安装 Visual Studio Code（可选）：如果你更喜欢使用轻量级的编辑器，可以安装 Visual Studio Code。

创建项目

1. 创建一个新的 .NET Core 项目：

   dotnet new webapi -n SteeltoeSample
   cd SteeltoeSample
   

2. 添加 Steeltoe 依赖：

   在 SteeltoeSample.csproj 文件中添加以下依赖：

   <PackageReference Include="Steeltoe.Discovery.ClientCore" Version="3.1.0" />
   <PackageReference Include="Steeltoe.Extensions.Configuration.CloudFoundryCore" Version="3.1.0" />
   

3. 配置服务发现：

   在 Startup.cs 文件中添加以下代码：

   using Steeltoe.Discovery.Client;
   
   public class Startup
   {
       public void ConfigureServices(IServiceCollection services)
       {
           services.AddDiscoveryClient(Configuration);
           services.AddControllers();
       }
   
       public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
       {
           if (env.IsDevelopment())
           {
               app.UseDeveloperExceptionPage();
           }
   
           app.UseRouting();
           app.UseEndpoints(endpoints =>
           {
               endpoints.MapControllers();
           });
   
           app.UseDiscoveryClient();
       }
   }
   

4. 运行项目：

   dotnet run
   

   项目启动后，你可以通过浏览器访问 http://localhost:5000 来查看默认的 API 接口。

应用案例和最佳实践

服务发现

SteeltoeOSS 提供了服务发现功能，可以让你轻松地将多个微服务注册到一个服务注册中心（如 Eureka 或 Consul）。以下是一个简单的示例：

public class ValuesController : ControllerBase
{
    private readonly IDiscoveryClient _discoveryClient;

    public ValuesController(IDiscoveryClient discoveryClient)
    {
        _discoveryClient = discoveryClient;
    }

    [HttpGet]
    public IEnumerable<string> Get()
    {
        var services = _discoveryClient.GetInstances("my-service");
        return services.Select(s => s.Uri.ToString()).ToArray();
    }
}

配置管理

SteeltoeOSS 还支持从外部配置源（如 Spring Cloud Config 或 Azure App Configuration）加载配置。以下是一个示例：

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddOptions();
        services.Configure<MyOptions>(Configuration.GetSection("MyOptions"));
    }
}

典型生态项目

Spring Cloud

SteeltoeOSS 与 Spring Cloud 生态系统紧密集成，可以与 Spring Cloud Config、Eureka、Hystrix 等项目无缝协作。

Azure Cloud

SteeltoeOSS 提供了与 Azure 云平台的深度集成，支持 Azure App Configuration、Azure Service Bus、Azure Cosmos DB 等。

Pivotal Cloud Foundry

SteeltoeOSS 是 Pivotal Cloud Foundry 官方支持的 .NET 微服务框架，可以轻松部署和管理 .NET 应用程序。

通过以上步骤，你可以快速上手 SteeltoeOSS，并开始构建云原生 .NET 应用程序。