Golang으로 백엔드를 구축하는 방법은?
이 튜토리얼에서는 Back4App을 사용하여 Golang의 완전한 백엔드를 구축하고 테스트하는 방법을 배웁니다.
우리는 데이터베이스 관리, 보안 설정, 사용자 인증, 파일 저장소 및 클라우드 코드와 같은 필수 Back4App 기능을 통합하여 Go http 서버와 잘 작동하는 안전하고 유연하며 확장 가능한 백엔드를 만드는 방법을 안내할 것입니다.
우리는 전용 Parse SDK 대신 Back4App의 RESTful API를 사용하여 Golang http 클라이언트에서 데이터베이스에 연결하는 방법에 중점을 두어 새로운 백엔드를 위한 유지 관리가 쉬운 핸들러 함수를 구축하는 방법을 설명할 수 있습니다.
이 접근 방식이 처음부터 자신의 서버를 설정하는 것에 비해 개발 복잡성을 어떻게 줄이는지 알 수 있습니다.
Back4App의 실시간 쿼리, 파일 저장소 및 사용자 인증 시스템에 의존함으로써 백엔드 생성 프로세스를 가속화할 수 있습니다.
마지막에는 안전한 Golang 백엔드를 구축하고, 자동화된 작업을 예약하며, 외부 웹훅을 통합하는 방법을 알게 될 것입니다.
이 기반을 생산 준비가 완료된 애플리케이션으로 확장하거나 필요에 따라 사용자 정의 논리를 추가할 준비가 잘 되어 있습니다.
- Go의 http 패키지 및 RESTful API에 대한 기본 지식 함수 핸들러를 작성하고, 오류 메시지를 구문 분석하고, 메서드 POST 요청을 처리하고, http 로컬호스트 서버를 설정하는 방법에 대한 친숙함이 도움이 될 것입니다.
진행하기 전에 이러한 전제 조건이 준비되어 있는지 확인하세요. 이 설정은 Back4App을 사용하여 Golang의 백엔드를 구축하는 방법을 발견하는 동안 경험을 간소화할 것입니다.
새로운 Back4App 프로젝트를 만드는 것이 첫 번째 단계입니다. 여기에서 데이터를 저장하고, 파일 저장소를 구성하고, 클라우드 기능을 예약하고, 백그라운드 작업을 추가합니다. 이 백엔드 프로젝트는 모든 후속 단계의 기초가 될 것입니다.
- Back4App 계정에 로그인하세요.
- “새 앱” 클릭 Back4App 대시보드에서.
- 앱 이름 지정하기 (예: “Golang-Backend-Tutorial”).
생성되면 대시보드에 나타납니다. 이 애플리케이션은 이제 Back4App 기반의 백엔드입니다.
Back4App은 데이터를 생성, 업데이트 및 삭제하기 위한 RESTful API를 제공합니다. Golang에서는 Go의 표준 라이브러리에서 http 클라이언트를 사용하여 이러한 엔드포인트와 통신할 것입니다.
“애플리케이션 ID”와 “REST API 키”를 찾으려면 Back4App 앱의 “설정” 또는 “보안 및 키” 섹션으로 가세요:
각 요청 헤더에 이러한 자격 증명이 필요합니다. 데이터베이스에 연결할 때 POST, GET 및 기타 HTTP 요청 방법을 사용하여 다음 단계에서 이를 설명하겠습니다.
Back4App에 데이터를 저장하려면 클래스(테이블)와 열(필드)을 정의해야 합니다. 예를 들어, Todo 클래스를 만들고 싶다고 가정해 보겠습니다. Back4App 대시보드에서 수동으로 생성할 수 있습니다:
- 앱 대시보드의 데이터베이스 섹션으로 이동합니다.
- “Todo”라는 새 클래스를 만듭니다.
- 제목(String) 및 완료 여부(Boolean)와 같은 열을 추가합니다.
Golang 애플리케이션에서 새 필드가 있는 객체를 전송하여 시스템이 열을 자동으로 생성하도록 할 수도 있습니다.
- AI 에이전트 열기 앱 대시보드에서.
- 원하는 데이터 모델 설명하기 (예: “제목 필드와 isCompleted 필드가 있는 새로운 Todo 클래스를 만들어 주세요.”).
- 제안된 스키마 수락하기
이 유용한 기능은 데이터베이스 스키마 설계에 소요되는 시간을 절약해 줍니다.
아래는 Go의 http 패키지를 사용하여 데이터를 생성(POST 메서드)하고 가져오는 방법에 대한 기본 예제입니다. APPLICATION_ID 및 REST_API_KEY를 환경 변수로 설정했다고 가정합니다.
이 예제에서는 http 클라이언트를 생성하고, 필요한 헤더를 추가하며, 응답 코드와 오류 메시지를 처리합니다. YOUR_APPLICATION_ID 및 YOUR_REST_API_KEY를 Back4App 프로젝트의 실제 키로 교체하는 것을 잊지 마세요.
Back4App는 또한 https://parseapi.back4app.com/graphql에 GraphQL 엔드포인트를 제공합니다. 인기 있는 Go GraphQL 클라이언트 라이브러리(예: Machine Box graphql)를 사용하여 쿼리 또는 변형을 수행할 수 있습니다. 이는 원시 REST 호출보다 더 구조화된 접근 방식이 될 수 있습니다.
앱에서 실시간 업데이트를 보고 싶다면 Back4App 대시보드에서 실시간 쿼리를 활성화할 수 있습니다. Golang에는 공식 Parse 실시간 쿼리 라이브러리가 없습니다. 그러나 wss://YOUR_SUBDOMAIN.b4a.io에서 실시간 쿼리 업데이트를 수신하기 위해 자체 웹소켓 연결을 구현할 수 있습니다. 이 기능은 즉각적인 데이터 동기화가 필요한 협업 앱에 유용합니다.
Back4App은 데이터 보호를 위해 접근 제어 목록(ACL)과 클래스 수준 권한(CLP)을 제공합니다. ACL은 각 객체에 정의되며, CLP는 전체 클래스에 대한 포괄적인 규칙을 정의합니다.
- Back4App에서 앱의 데이터베이스 뷰로 이동합니다.
- 클래스를 선택합니다 (예: Todo).
- 클래스 수준 권한을 클릭하고 다양한 사용자 역할 또는 공개 액세스를 위한 읽기/쓰기 액세스를 설정합니다.
REST 호출을 통해 객체를 생성하거나 업데이트할 때 ACL을 전달할 수 있습니다. 이를 통해 특정 사용자 또는 역할만 데이터에 대한 읽기/쓰기를 할 수 있습니다. 자세한 내용은 앱 보안 가이드라인을 방문하세요.
클라우드 코드는 서버를 관리하지 않고도 서버 측 함수, 트리거 또는 유효성 검사를 실행할 수 있게 해줍니다. 서버 측에서 고급 비즈니스 로직을 추가하거나 외부 API를 통합할 수 있습니다.
간단한 예는 텍스트 길이를 계산하는 함수입니다. Back4App 대시보드의 main.js 파일에서:
다음 방법 중 하나로 Cloud Code를 배포합니다:
- Back4App CLI:
- Back4App 대시보드에서 Cloud Code > Functions. 코드를 main.js 편집기에 붙여넣고 배포를 클릭합니다.
http 클라이언트를 통해 REST를 통해 Cloud Function을 호출할 수 있습니다:
Back4App은 User 클래스를 사용하여 인증을 수행합니다. REST를 통해 새 사용자를 생성하면, 백엔드는 자격 증명을 안전하게 저장하고 세션 토큰을 생성합니다.
반환된 세션 토큰을 사용하여 사용자 권한이 필요한 후속 요청을 수행합니다. Go에서는 앞서 설명한 대로 http 클라이언트에서 동일한 유형의 HTTP 요청을 보낼 수 있습니다.
Google이나 Facebook과 같은 소셜 로그인을 위해서는 Back4App에서 OAuth 설정을 구성해야 합니다. 이러한 흐름은 종종 토큰 교환을 포함합니다. 자세한 내용은 Apple로 로그인 / 소셜 로그인 문서를 참조하십시오.
파일을 base64 인코딩된 데이터 또는 multipart/form-data로 Back4App에 저장할 수 있습니다:
업로드 후, 반환된 파일 URL 또는 파일 포인터를 저장하여 객체에 파일을 첨부할 수 있습니다. Go에서는 같은 방식으로 http 요청을 생성하세요—파일 내용을 올바르게 인코딩하는 것을 잊지 마세요.
이메일 인증은 사용자가 제공한 이메일을 제어할 수 있도록 보장하며, 비밀번호 재설정은 계정을 복구하는 데 도움을 줍니다. 두 기능 모두 보안과 신뢰를 높입니다.
- 당신의 Back4App 대시보드로 가세요.
- 이메일 설정 아래에서 이메일 인증을 활성화하세요.
- 필요한 경우 이메일 템플릿을 사용자 정의하세요.
사용자가 가입하면 인증 이메일이 자동으로 전송됩니다.
비밀번호 재설정을 시작하려면 requestPasswordReset REST 엔드포인트를 사용하세요:
클라우드 작업은 일정에 따라 실행되어 오래된 데이터를 정리하거나 주간 뉴스레터를 보내는 등의 작업을 자동화합니다.
이 작업을 배포하고 Back4App 대시보드 > 앱 설정 > 서버 설정 > 백그라운드 작업에서 예약하세요.
웹훅을 사용하면 특정 이벤트가 발생할 때 외부 서비스에 알릴 수 있습니다. 예를 들어, 새로운 Todo 항목이 생성될 때 Slack 알림을 보낼 수 있습니다.
- 웹훅으로 가기 Back4App 대시보드의 섹션.
- 엔드포인트 구성하기 (예: https://your-external-service.com/webhook).
- 트리거 할당하기 (예: Todo)의 afterSave.
이벤트에 대한 직접적인 제어를 원할 경우, 클라우드 코드에서 http 클라이언트 요청을 작성하여 외부 API를 트리거할 수도 있습니다.
Back4App 관리 앱은 비기술 팀원과 공유하여 데이터를 관리할 수 있는 포인트 앤 클릭 인터페이스입니다.
- Back4App 대시보드에서 더보기 > 관리 앱으로 이동하세요.
- 활성화하고 관리 사용자를 생성하세요.
선택한 서브도메인을 사용하여 데이터 조작을 위한 간단한 UI에 로그인하세요. 이렇게 하면 기본 작업을 수행하기 위해 직접 쿼리나 사용자 정의 코드를 작성할 필요가 없습니다.
이 가이드에서는 Back4App을 사용하여 Golang의 백엔드를 구축하는 방법을 알아보았습니다.
RESTful API를 통해 데이터베이스에 연결하고, ACL 및 CLP로 보안 조치를 적용하며, Cloud Jobs로 예약 작업을 실행하고, Webhooks를 사용하여 외부 서비스와 통합하고, 사용자 인증 및 파일 저장을 설정하는 방법을 탐색했습니다.
Go의 http 패키지와 Back4App의 강력한 기능을 활용하여 시간을 절약하고 쉽게 확장할 수 있는 강력한 백엔드를 만들 수 있습니다.
기본 사항을 마스터했으므로 Golang 핸들러 함수 로직을 확장하고, 새로운 API 엔드포인트에 연결하며, 필요에 맞는 풍부한 애플리케이션을 구축할 수 있습니다.
- Golang 앱 개선: 역할 기반 접근과 같은 고급 기능을 추가하거나, 프로덕션을 위해 http 서버를 최적화하세요.
- 실시간 쿼리에 대해 더 알아보기: 협업 앱을 위한 라이브 쿼리를 통합하세요.
- 고급 Back4App 문서 탐색: ACL, 로그 및 분석을 세밀하게 조정하세요.
- 타사 API 통합: Cloud Code 또는 직접 웹훅을 사용하여 백엔드 기능을 확장하세요.