.NET Aspire MySQL 통합

포함:호스팅 통합 및 Client 통합

MySQL SQL(구조적 쿼리 언어)을 사용하여 데이터를 관리하고 조작하는 오픈 소스 RDBMS(관계형 데이터베이스 관리 시스템)입니다. 소규모 프로젝트에서 대규모 엔터프라이즈 시스템에 이르기까지 다양한 환경에서 사용되며 클라우드 네이티브 애플리케이션에서 마이크로 서비스를 뒷받침하는 데이터를 호스트하는 것이 좋습니다. .NET Aspire MySQL 데이터베이스 통합을 사용하면 기존 MySQL 데이터베이스에 연결하거나 mysql 컨테이너 이미지사용하여 .NET 새 인스턴스를 만들 수 있습니다.

호스팅 통합

MySQL 호스팅 통합은 serverMySqlServerResource 형식으로, 데이터베이스를 MySqlDatabaseResource 형식으로 모델화합니다. 이러한 형식 및 API에 액세스하려면 앱 호스트 프로젝트에서 📦Aspire호스팅MySql NuGet 패키지를 추가합니다.

dotnet add package Aspire.Hosting.MySql

<PackageReference Include="Aspire.Hosting.MySql"
                  Version="*" />

자세한 내용은 dotnet add package 또는 .NET 애플리케이션에서 패키지 종속성을 관리하기를 참조하세요.

MySQL server 리소스 및 데이터베이스 리소스 추가

앱 호스트 프로젝트에서 AddMySql을 호출하여 MySQL 리소스 빌더를 추가 및 반환합니다. 반환된 리소스 작성기를 AddDatabase에 사슬처럼 연결하여 MySQL 데이터베이스 리소스를 추가합니다.

var builder = DistributedApplication.CreateBuilder(args);

var mysql = builder.AddMySql("mysql")
                   .WithLifetime(ContainerLifetime.Persistent);

var mysqldb = mysql.AddDatabase("mysqldb");

var myService = builder.AddProject<Projects.ExampleProject>()
                       .WithReference(mysqldb)
                       .WaitFor(mysqldb);

// After adding all resources, run the app...

.NET .NET Aspire mysql 이미지와 함께 이전 예제와 같이 앱 호스트에 컨테이너 이미지를 추가하면 로컬 컴퓨터에 새 MySQL 인스턴스가 만들어집니다. MySQL 리소스 작성기(mysql 변수)에 대한 참조는 데이터베이스를 추가하는 데 사용됩니다. 데이터베이스의 이름이 mysqldb로 지정된 후 ExampleProject에 추가됩니다. MySQL 리소스에는 기본 자격 증명으로 username이 root와 함께 포함되어 있으며, CreateDefaultPasswordParameter 메서드를 사용하여 생성된 임의의 password가 포함됩니다.

앱 호스트가 실행되면 암호가 앱 호스트의 비밀 저장소에 저장됩니다. 예를 들어 Parameters 섹션에 추가되었습니다.

{
  "Parameters:mysql-password": "<THE_GENERATED_PASSWORD>"
}

매개 변수의 이름은 mysql-password, 실제로는 리소스 이름에 -password 접미사를 사용하여 서식을 지정하는 것입니다. 자세한 내용은 개발 시 앱 비밀의 안전한 스토리지를 참조하고 매개 변수 리소스 추가를 참조하세요.

WithReference 메서드는 ExampleProject 내의 mysqldb로 명명된 연결을 구성합니다.

데이터 볼륨을 사용하여 MySQL 리소스 추가

SQL Server 리소스에 데이터 볼륨을 추가하려면 SQL Server 리소스에서 WithDataVolume 메서드를 호출합니다.

var builder = DistributedApplication.CreateBuilder(args);

var mysql = builder.AddMySql("mysql")
                   .WithDataVolume();

var mysqldb = mysql.AddDatabase("mysqldb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(mysqldb)
       .WaitFor(mysqldb);

// After adding all resources, run the app...

데이터 볼륨은 컨테이너의 수명 주기 외부에서 MySQLserver 데이터를 유지하는 데 사용됩니다. 데이터 볼륨은 SQL Server 컨테이너의 /var/lib/mysql 경로에 탑재되고 name 매개 변수가 제공되지 않으면 이름이 임의로 생성됩니다. 데이터 볼륨에 대한 정보 및바인드 마운트보다 선호되는 이유는 문서: 볼륨를 참조하세요.

데이터 연결 마운트를 사용하여 MySQL 리소스를 추가하십시오.

MySQL 리소스에 데이터 바인딩 탑재를 추가하려면 WithDataBindMount 메서드를 호출합니다.

var builder = DistributedApplication.CreateBuilder(args);

var mysql = builder.AddMySql("mysql")
                   .WithDataBindMount(source: @"C:\MySql\Data");

var db = sql.AddDatabase("mysqldb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(mysqldb)
       .WaitFor(mysqldb);

// After adding all resources, run the app...

데이터 바인드 마운트는 호스트 컴퓨터의 파일 시스템을 사용하여 컨테이너가 재시작될 때 MySQL 데이터를 지속시킵니다. 데이터 바인드 마운트는 호스트 컴퓨터의 MySQL 컨테이너에서 Windows의 C:\MySql\Data 경로에 (또는 Unix의 /MySql/Data 경로에) 마운트됩니다. 데이터 바인드 마운트에 대한 자세한 내용은 Docker 문서:바인드 마운트를 참조하세요.

매개 변수를 사용하여 MySQL 리소스 추가

루트 MySQL 암호를 명시적으로 제공하려는 경우 매개 변수로 전달할 수 있습니다. 다음 대체 예제를 고려합니다.

var password = builder.AddParameter("password", secret: true);

var mysql = builder.AddMySql("mysql", password)
                   .WithLifetime(ContainerLifetime.Persistent);

var mysqldb = mysql.AddDatabase("mysqldb");

var myService = builder.AddProject<Projects.ExampleProject>()
                       .WithReference(mysqldb)
                       .WaitFor(mysqldb);

자세한 내용은외부 매개 변수를 참조하세요.

PhpMyAdmin 리소스 추가

phpMyAdmin는 MySQL인기 있는 웹 기반 관리 도구입니다. 데이터베이스, 테이블, 뷰 및 인덱스와 같은 MySQL 개체를 찾아 수정하는 데 사용할 수 있습니다. .NET .NET Aspire 솔루션 내에서 phpMyAdmin을 사용하려면 WithPhpMyAdmin 메서드를 호출합니다. 이 메서드는 phpMyAdmin을 호스트하고 MySQL 컨테이너에 연결하는 솔루션에 새 컨테이너 리소스를 추가합니다.

var builder = DistributedApplication.CreateBuilder(args);

var mysql = builder.AddMySql("mysql")
                   .WithPhpMyAdmin();

var db = sql.AddDatabase("mysqldb");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(mysqldb)
       .WaitFor(mysqldb);

// After adding all resources, run the app...

솔루션을 실행할 때, phpMyAdmin 리소스와 엔드포인트가 포함된 정보가 .NET.NET Aspire 대시보드에 표시됩니다. 엔드포인트에 대한 링크를 선택하여 새 브라우저 탭에서 phpMyAdmin을 봅니다.

통합 호스팅 건강 검사

MySQL 호스팅 통합은 MySQL 리소스에 대한 상태 검사를 자동으로 추가합니다. 건강 검사는 MySQLserver이 실행 중인지와 연결이 설정될 수 있는지를 확인합니다.

호스팅 통합은 AspNetCore.HealthChecks 📦와MySql NuGet 패키지에 의존합니다.

Client 통합

.NET Aspire MySQL 데이터베이스 통합을 시작하려면, client-consuming 프로젝트, 즉 MySQLclient을 사용하는 애플리케이션에 대한 프로젝트에 📦AspireNuGet 패키지의 MySqlConnector를 설치합니다. MySQL client 통합은 MySQLserver상호 작용하는 데 사용할 수 있는 MySqlConnector.MySqlDataSource 인스턴스를 등록합니다.

dotnet add package Aspire.MySqlConnector

<PackageReference Include="Aspire.MySqlConnector"
                  Version="*" />

자세한 내용은 dotnet add package 또는 .NET 애플리케이션에서 패키지 종속성을 관리하기를 참조하세요.

MySQL 데이터 원본 추가

프로젝트에서 client을 사용 중일 때, Program.cs 파일에서 AddMySqlDataSource 확장 메서드를 호출하여 MySqlDataSource을(를) 종속성 주입 컨테이너를 통해 사용할 수 있도록 등록합니다. 메서드는 connectionName 매개 변수를 사용합니다.

builder.AddMySqlDataSource(connectionName: "mysqldb");

그런 다음 종속성 주입을 사용하여 MySqlConnector.MySqlDataSource 인스턴스를 검색할 수 있습니다. 예를 들어 예제 서비스에서 데이터 원본을 검색하려면 다음을 수행합니다.

public class ExampleService(MySqlDataSource dataSource)
{
    // Use dataSource...
}

종속성 주입에 대한 자세한 내용은 .NET 종속성 주입참조하세요.

키가 지정된 MySQL 데이터 원본 추가

여러 MySqlDataSource 인스턴스를 서로 다른 연결 이름으로 등록하려는 경우가 있을 수 있습니다. 키 MySQL 데이터 원본을 등록하려면 AddKeyedMySqlDataSource 메서드를 호출하십시오.

builder.AddKeyedMySqlDataSource(name: "mainDb");
builder.AddKeyedMySqlDataSource(name: "loggingDb");

그런 다음 종속성 주입을 사용하여 MySqlDatSource 인스턴스를 검색할 수 있습니다. 예를 들어 예제 서비스에서 연결을 검색하려면 다음을 수행합니다.

public class ExampleService(
    [FromKeyedServices("mainDb")] MySqlDataSource mainDbConnection,
    [FromKeyedServices("loggingDb")] MySqlDataSource loggingDbConnection)
{
    // Use connections...
}

키 지정된 서비스에 대한 자세한 내용은 .NET 종속성 주입: 키 지정 서비스를참조하세요.

구성

.NET Aspire MySQL 데이터베이스 통합은 프로젝트의 요구 사항 및 규칙에 따라 연결을 구성하는 여러 옵션을 제공합니다.

연결 문자열 사용

ConnectionStrings 구성 섹션에서 연결 문자열을 사용하는 경우 AddMySqlDataSource 메서드를 호출할 때 연결 문자열의 이름을 제공할 수 있습니다.

builder.AddMySqlDataSource(connectionName: "mysql");

그런 다음 ConnectionStrings 구성 섹션에서 연결 문자열을 검색합니다.

{
  "ConnectionStrings": {
    "mysql": "Server=mysql;Database=mysqldb"
  }
}

이 연결 문자열의 서식을 지정하는 방법에 대한 자세한 내용은 MySqlConnector: ConnectionString 설명서참조하세요.

구성 공급자 사용

.NET Aspire MySQL 데이터베이스 통합은 Microsoft.Extensions.Configuration지원합니다. 구성에서 Aspire:MySqlConnector 키를 사용하여 MySqlConnectorSettings를 로드합니다. 다음 코드 조각은 일부 옵션을 구성하는 appsettings.json 파일의 예입니다.

{
  "Aspire": {
    "MySqlConnector": {
      "ConnectionString": "YOUR_CONNECTIONSTRING",
      "DisableHealthChecks": true,
      "DisableTracing": true
    }
  }
}

전체 MySQL 통합 JSON 스키마는 Aspire참조하세요. MySqlConnector/ConfigurationSchema.json.

인라인 대리자 사용

또한 일부 또는 모든 옵션을 코드 내에서 인라인으로 설정하기 위해 Action<MySqlConnectorSettings> 델리게이트를 전달할 수 있으며, 예를 들어 코드에서 상태 검사를 비활성화할 수 있습니다.

builder.AddMySqlDataSource(
    "mysql",
    static settings => settings.DisableHealthChecks  = true);

Client 통합 시스템 상태 점검

기본적으로 .NET.NET Aspire 통합은 모든 서비스에 대해 상태 검사를 가능하게 합니다. 자세한 내용은 .NET.NET Aspire 통합 개요참조하세요.

.NET Aspire MySQL 데이터베이스 통합:

• MySqlConnectorSettings.DisableHealthChecks가 false상태일 때, 연결을 만들 수 있는지와 MySQL 데이터베이스에 대해 명령을 실행할 수 있는지를 검증하는 상태 검사를 추가합니다.
• 앱이 트래픽을 수락할 준비가 되었다고 간주되려면 등록된 모든 상태 확인을 통과해야 함을 지정하는 /health HTTP 엔드포인트와 통합됩니다.

관찰 가능성 및 원격 분석

.NET .NET Aspire 통합은 로깅, 추적 및 메트릭 구성을 자동으로 설정하며, 이를 관찰성의 기둥이라고도 로 불립니다. 통합 관찰 가능성 및 원격 분석에 대한 자세한 내용은 .NET.NET Aspire 통합 개요참조하세요. 지원 서비스에 따라 일부 통합은 이러한 기능 중 일부만 지원할 수 있습니다. 예를 들어 일부 통합은 로깅 및 추적을 지원하지만 메트릭은 지원하지 않습니다. 구성 섹션에 제시된 기술을 사용하여 원격 분석 기능을 사용하지 않도록 설정할 수도 있습니다.

로깅

.NET Aspire MySQL 통합은 다음 로그 범주를 사용합니다.

• MySqlConnector.ConnectionPool
• MySqlConnector.MySqlBulkCopy
• MySqlConnector.MySqlCommand
• MySqlConnector.MySqlConnection
• MySqlConnector.MySqlDataSource

추적

.NET Aspire MySQL 통합은 OpenTelemetry를 사용하여 다음과 같은 추적 활동을 발생시킨다.

• MySqlConnector

지표

.NET Aspire MySQL 통합은 OpenTelemetry사용하여 다음 메트릭을 내보낸다.

• MySqlConnector
  • db.client.connections.create_time
  • db.client.connections.use_time
  • db.client.connections.wait_time
  • db.client.connections.idle.max
  • db.client.connections.idle.min
  • db.client.connections.max
  • db.client.connections.pending_requests
  • db.client.connections.timeouts
  • db.client.connections.usage

참고

• MySQL 데이터베이스
• .NET .NET Aspire 데이터베이스 컨테이너 샘플
• .NET .NET Aspire 통합
• .NET Aspire GitHub 리포지토리