0Pricing
C# Academy · 강의

복원력 파이프라인

전략을 복원력 파이프라인으로 결합합니다.

복원력 파이프라인은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

전략 조합하기

실제 복원력에는 보통 여러 전략이 함께 필요합니다. 폴리 v8에서는 ResiliencePipelineBuilder를 사용해 여러 전략을 하나의 복원력 pipeline으로 조합할 수 있습니다.

ResiliencePipelineBuilder

Add... 호출을 연이어 작성하고 Build()로 마무리합니다. 그 결과 재사용 가능하고 스레드 안전한 ResiliencePipeline이 만들어지며, 이를 통해 호출을 실행합니다.

var pipeline = new ResiliencePipelineBuilder()
    .AddRetry(new RetryStrategyOptions())
    .AddTimeout(TimeSpan.FromSeconds(5))
    .Build();

순서가 중요합니다

전략은 바깥에서 안쪽 순서로 실행됩니다. 처음 추가한 전략이 나머지 전략을 감쌉니다. 일반적으로 올바른 순서는 시도별 시간 제한을 재시도 안쪽에 배치하고, 전체 시간 제한과 회로 차단기를 그 바깥에 두는 것입니다.

var pipeline = new ResiliencePipelineBuilder()
    .AddTimeout(TimeSpan.FromSeconds(10))      // overall
    .AddRetry(new RetryStrategyOptions())
    .AddCircuitBreaker(new CircuitBreakerStrategyOptions())
    .AddTimeout(TimeSpan.FromSeconds(2))       // per attempt
    .Build();

형식이 지정된 pipeline

대체 처리나 결과 기반 재시도처럼 전략이 결과를 검사할 때는 제네릭 ResiliencePipelineBuilder<T>를 사용하여 pipeline이 반환 형식을 알 수 있도록 하십시오.

var pipeline = new ResiliencePipelineBuilder<HttpResponseMessage>()
    .AddRetry(new HttpRetryStrategyOptions())
    .Build();

상태를 전달하여 실행하기

클로저가 할당되는 것을 피하려면 ExecuteAsync에 상태를 전달하십시오. 그러면 폴리가 해당 상태를 콜백에 다시 전달합니다.

await pipeline.ExecuteAsync(
    static async (state, token) => await state.CallAsync(token),
    myService);

ResiliencePipelineProvider

pipeline을 코드 안에서 직접 만드는 대신, DI에 이름이 지정된 pipeline을 등록하고 ResiliencePipelineProvider를 통해 가져오십시오. 이렇게 하면 구성을 중앙에서 관리할 수 있습니다.

builder.Services.AddResiliencePipeline("db", pipeline =>
{
    pipeline.AddRetry(new RetryStrategyOptions())
            .AddTimeout(TimeSpan.FromSeconds(3));
});

이름이 지정된 pipeline 가져오기

ResiliencePipelineProvider<string>을 주입하고 필요한 곳에서 키를 사용해 pipeline을 가져오십시오.

public class OrderService
{
    private readonly ResiliencePipeline _pipeline;
    public OrderService(ResiliencePipelineProvider<string> provider)
    {
        _pipeline = provider.GetPipeline("db");
    }
}

HttpClient의 복원력

AddResilienceHandler 확장은 형식이 지정되었거나 이름이 지정된 HttpClient에 pipeline을 연결하여 모든 외부 요청에 적용합니다.

builder.Services.AddHttpClient<CatalogClient>()
    .AddResilienceHandler("catalog", b =>
    {
        b.AddRetry(new HttpRetryStrategyOptions());
        b.AddCircuitBreaker(new HttpCircuitBreakerStrategyOptions());
    });

표준 복원력 처리기

Microsoft는 권장 순서에 따라 합리적인 재시도, 회로 차단기, 시간 제한 및 요청률 제한을 모두 제공하는 AddStandardResilienceHandler를 제공합니다.

builder.Services.AddHttpClient<CatalogClient>()
    .AddStandardResilienceHandler();

Pipeline은 재사용 가능하고 비용이 적습니다

pipeline을 한 번 만들고 여러 실행에서 재사용하십시오. pipeline은 변경할 수 없고 스레드 안전하므로 공유해도 안전하며 효율적입니다.

관찰성 확장 지점

모든 전략은 콜백(OnRetry, OnOpened, OnTimeout, OnFallback)을 제공하며, 폴리는 전체 상황을 파악할 수 있도록 로그 기록 및 메트릭과 연결할 수 있는 원격 측정 데이터를 내보냅니다.

빠른 확인

복원력 pipeline을 테스트합니다.

요약

ResiliencePipelineBuilder는 재시도, 회로 차단기, 시간 제한 및 대체 처리를 하나의 재사용 가능한 pipeline으로 조합합니다. 실행 순서는 바깥에서 안쪽이므로 전략의 순서가 중요합니다. 결과를 인식하는 전략에는 제네릭 작성기를 사용하고, AddResiliencePipeline으로 이름이 지정된 pipeline을 등록한 다음 ResiliencePipelineProvider를 통해 가져오십시오. HTTP의 경우 AddResilienceHandler 또는 AddStandardResilienceHandler가 모든 요청을 보호합니다.

자주 묻는 질문

“복원력 파이프라인” 강의는 무료인가요?

네 — “복원력 파이프라인” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“복원력 파이프라인”에서 뭘 배우나요?

전략을 복원력 파이프라인으로 결합합니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

C# Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“복원력 파이프라인” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 재시도 정책
  2. 회로 차단기 패턴
  3. 시간 제한 및 대체 정책
  4. 복원력 파이프라인
← C# Academy(으)로 돌아가기