Pericia.CleverCloudHelper 0.2.0-preview02

Pericia.CleverCloudHelper

Un peu d'aide pour configurer et déployer son application ASP.NET Core dans Clever Cloud

Chargement des ConnectionStrings

Lorsqu'on déploie une application liée à une base de données, les informations de connexion sont accessibles sous forme de variables d'environnement.

Pour les utiliser plus facilement, cette librairie les renvoie sous forme de ConnectionString :

CcEnvironment.MySqlConnectionString
CcEnvironment.PgsqlConnectionString

Afin d'accéder à ces connection strings depuis la configuration, vous pouvez appeler builder.AddCcEnvironment() dans ConfigureAppConfiguration :

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((ctx, builder) =>
        {
            builder.SetBasePath(Directory.GetCurrentDirectory())
                        .AddJsonFile("appsettings.json")
                        .AddJsonFile($"appsettings.{ctx.HostingEnvironment.EnvironmentName}.json", optional: true)
                        .AddCcEnvironment()
                        .AddEnvironmentVariables();
            
            if (ctx.HostingEnvironment.IsDevelopment())
            {
                builder.AddUserSecrets<Startup>();
            }
        })
        .UseStartup<Startup>()
        .Build();

Afin de pouvoir utiliser des valeurs différentes sur son poste de développement, ajoutez les chaines de connexion dans votre fichier appsettings.Development.json ou vos user secrets

{
    "ConnectionStrings": {
        "PostgreSql": "Host=localhost;Port=5432;Database=dbName;Username=usr;Password=pwd",
        "MySql": "Server=localhost;Port=3306;Database=dbName;Uid=usr;Pwd=pwd"
    }
}

Ainsi, vos chaines de connexion sont accessibles depuis IConfiguration :

configuration.GetConnectionString("PostgreSql");
configuration.GetConnectionString("MySql");

Autorisation du reverse-proxy Clever Cloud

Une fois déployée dans Clever Cloud, votre application sera derrière un load-balancer, et il vous faudra donc la configurer en conséquence.

Ajoutez l'appel à la méthode services.ConfigureCcProxy(); dans ConfigureServices, et app.UseForwardedHeaders(); au début de Configure :

public void ConfigureServices(IServiceCollection services)
{
    services.ConfigureCcProxy();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseForwardedHeaders();

    app.Run(async (context) =>
    {
        context.Response.ContentType = "text/plain";
        await context.Response.WriteAsync("Request Url: " + context.Request.GetDisplayUrl());
    });
}

Variables d'environnement

Les principales variables d'environnement sont accessibles depuis la classe statique CcEnvironment, ou depuis IConfiguration (si vous avez appelé la méthode builder.AddCcEnvironment()).

Common

.NET

Addons