Node.js 재시도 (개발자 관점에서의 작동 방식)

사용자 재시도 작동 방식

• 첫 번째 시도: 작업을 수행하려는 시도가 이루어집니다. 성공적이라면 기존 방식대로 사업이 계속될 것입니다. 절차가 일시적인 오류로 인해 실패할 경우 재시도 메커니즘이 활성화됩니다.

• 지연 시간을 늘려가며 재시도: 시스템은 실패한 작업을 다시 시도하기 전에 잠시 멈춥니다. 재시도 횟수가 늘어날수록 다음 시도 사이의 지연 시간도 증가합니다. 이러한 접근 방식을 통해 시스템은 자원을 과도하게 소모하지 않고도 일시적인 문제에서 복구할 수 있습니다.

• 지수적 백오프: 이 방법은 재시도 간격을 지수적으로 증가시키는 방식입니다. 예를 들어, 지연 시간은 몇 밀리초에서 시작하여 재시도할 때마다 두 배로 늘어날 수 있습니다. 이러한 기하급수적 증가는 리소스가 복구될 수 있도록 하여 시스템이 끊임없는 재시도로 인해 과부하되는 것을 방지합니다.

• 최대 재시도 횟수: 재시도 과정은 작업이 성공하거나 최대 재시도 횟수에 도달할 때까지 계속됩니다. 최대 재시도 횟수 제한을 설정함으로써 과도한 요청과 무한 재시도를 방지하여 리소스 고갈이나 장시간 다운타임을 예방할 수 있습니다.

사용자 재시도 기능 사용의 이점

• 향상된 복원력: 사용자 재시도 패턴을 사용하는 시스템은 일시적인 오류에 대한 복원력이 뛰어나 사람의 개입 없이도 원활하게 복구됩니다.

• 자원 부담 감소: 재시도 간격이 길어지면 대상 자원에 대한 부담과 실패 횟수가 줄어들어 시스템 안정성이 향상됩니다.

• 빠른 복구: 지수 백오프는 재시도 간격을 조정하여 재시도 성공 확률을 높임으로써 시스템이 일시적인 문제로부터 더 빠르게 복구할 수 있도록 합니다.

• 사용자 경험 향상: 일시적인 오류에 대한 투명한 처리 덕분에 사용자는 중단 및 지연을 덜 경험하고 더욱 원활하고 안정적인 사용자 경험을 누릴 수 있습니다.

Node.js 에서 재시도 기능을 생성하고 사용하세요

Node.js 의 주요 모듈 중 하나인 retry 모듈은 Node.js 에서 작업을 재시도하는 과정을 간소화합니다. 이 모듈은 네트워크 요청이나 기타 비동기 프로세스 중에 발생할 수 있는 일시적인 오류를 더 쉽게 처리할 수 있도록 해줍니다. 다음은 Node.js 에서 재시도 로직을 구현하는 방법에 대한 자세한 가이드입니다.

Node.js 설치하세요.

아직 Node.js 설치하지 않았다면 Node.js 공식 웹사이트 에서 다운로드하여 설치하세요.

Node.js 프로젝트 생성

프로젝트를 위한 새 디렉토리를 생성하고 터미널 또는 명령 프롬프트를 통해 해당 디렉토리 안으로 이동하세요.

mkdir retry-example
cd retry-example

mkdir retry-example
cd retry-example

Node.js 프로젝트를 초기화하여 새 프로젝트를 설정하세요.

npm init -y

npm init -y

이 작업은 프로젝트 디렉토리에 package.json 파일을 생성합니다.

재시도 모듈을 설치하세요

참고: 본래 Node.js와 달리, 재시도 기능은 보통 async-retry과 같은 에코시스템 내 npm 패키지에 의해 제공됩니다.

재시도 로직을 구현하세요

아래는 async-retry 모듈을 사용하여 재시도 로직을 구축하는 방법을 보여주는 Node.js 코드 예제입니다. 이 예시에서는 가상의 네트워크 요청이 이루어지며, 일시적인 문제로 인해 실패할 경우 지수 백오프 방식으로 재시도됩니다.

const retry = require('async-retry');

// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const isSuccess = Math.random() < 0.5;
    if (isSuccess) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}

// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};

// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);

// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

const retry = require('async-retry');

// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const isSuccess = Math.random() < 0.5;
    if (isSuccess) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}

// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};

// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);

// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

IronPDF 통합

IronPDF 에 재시도 로직을 결합하면 Node.js 애플리케이션에서 안정적인 PDF 생성이 가능합니다.

IronPDF를 설치하세요

먼저 npm을 사용하여 IronPDF 라이브러리를 설치합니다.

 npm과 @ironsoftware/ironpdf

IronPDF 가져오기 및 구성

IronPDF 사용하려면 먼저 라이선스 키(구매한 경우)를 사용하여 가져오고 구성해야 합니다.

const IronPdf = require("@ironsoftware/ironpdf");
const config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });
const PdfDocument = IronPdf.PdfDocument;

const IronPdf = require("@ironsoftware/ironpdf");
const config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });
const PdfDocument = IronPdf.PdfDocument;

PDF 생성 기능 정의

IronPDF 사용하여 PDF를 생성하는 함수를 만드세요:

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

PDF 생성에 대한 재시도 로직을 구현하세요

PDF 생성을 처리하기 위해 async-retry을 사용하여 재시도 로직을 통합합니다:

const retry = require('async-retry');

async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3,          // Maximum number of retry attempts
        factor: 2,           // Exponential backoff factor
        minTimeout: 1000,    // Initial retry delay in milliseconds
        maxTimeout: 60000,   // Maximum retry delay in milliseconds
        randomize: true      // Randomize retry delays
    });
}

const retry = require('async-retry');

async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3,          // Maximum number of retry attempts
        factor: 2,           // Exponential backoff factor
        minTimeout: 1000,    // Initial retry delay in milliseconds
        maxTimeout: 60000,   // Maximum retry delay in milliseconds
        randomize: true      // Randomize retry delays
    });
}

재시도 로직을 포함한 PDF 생성

이제 retryGeneratePdf 함수를 사용하여 재시도 로직이 포함된 PDF를 생성할 수 있습니다:

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
        await pdf.saveAs('output.pdf');
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
        await pdf.saveAs('output.pdf');
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });

사용자 지정 옵션: 애플리케이션에 필요한 재시도 전략 및 오류 처리를 사용자 지정하고, 모니터링 및 디버깅을 위해 로깅 기능을 통합할 수 있습니다.

IronPDF 에 재시도 로직을 결합하면 Node.js 애플리케이션에서 PDF 생성 중 발생하는 오류를 안정적으로 처리하고 안정성을 향상시킬 수 있습니다.