Starlight Hyperlift 초기 설정
Starlight™ Hyperlift는 인프라가 아닌 제품에 집중할 수 있도록 해주는 클라우드 배포 플랫폼입니다. Dockerfile 경로만 지정하면 Hyperlift가 GitHub에서 코드를 가져옵니다. 이후 컨테이너 이미지를 빌드하고 배포하여 제품을 바로 출시할 수 있습니다.
아직 완전한 프로덕션 애플리케이션이 없다면, 샘플 저장소를 이용한 Starlight™ Hyperlift 테스트 배포를 준비해 두었습니다. 이를 통해 프로덕션 환경으로 이동하기 전에 빌드 및 배포 과정을 빠르게 테스트할 수 있습니다.
Hyperlift 시작은 빠르고 쉽습니다. 도움이 필요하다면, Dockerfile 경로 지정부터 프로젝트 출시까지 각 단계를 안내하는 영상을 준비했습니다.
Hyperlift 설정 방법
앱을 실행하려면 다음이 필요합니다:
Starlight Hyperlift Manager로 이동하여 GitHub 저장소를 연결하세요.
지정한 저장소에 Dockerfile을 추가하세요. 반드시 유효한 베이스 이미지로 시작해야 합니다.
Hyperlift는 애플리케이션의 청사진으로 적절한 Dockerfile에 의존합니다. 이를 통해 패키지 설치, 파일 추가, 앱 요구 사항에 맞는 환경 설정이 가능합니다.
공식 Dockerfile 문서를 참고하셔도 좋습니다.
참고! 애플리케이션의 포트를 열려면 Dockerfile에서 노출하는 대신 환경 변수를 사용하세요.GitHub 계정 연결이 완료되면 Hyperlift Manager 메뉴로 리디렉션됩니다. 여기서 설정 사이드 패널이 자동으로 열리며 구성을 계속할 수 있습니다:
동일한 사이드 패널은 Hyperlift Manager 메뉴 > 설정에서도 접근할 수 있습니다:
애플리케이션 설정이 완료되면 빌드 후 배포할 수 있습니다. 애플리케이션 빌드를 시작하려면 빌드 버튼을 클릭하세요:
프로세스가 성공적으로 완료되면 배포가 자동으로 시작됩니다. 이 시점에서 결제가 활성화됩니다. 관련 정보는 다음 알림에 표시됩니다:
모든 설정이 완료되고 애플리케이션이 실행되면 필요에 따라 애플리케이션을 시작, 중지 또는 재시작할 수 있습니다:
Hyperlift Manager 분할 메뉴
분할 메뉴에서도 Hyperlift 애플리케이션을 관리할 수 있습니다. 여기에서 다음 메뉴를 사용할 수 있습니다:
환경 변수 - API 키, 데이터베이스 URL, 포트, 구성 세부 정보 등 설정을 저장합니다.
참고: 기본 Hyperlift 애플리케이션 포트는 8080이지만, 이 메뉴에서 변경 및 업데이트할 수 있습니다.애플리케이션 설정 - 여기에서 애플리케이션 이름, GitHub 저장소, 저장소 브랜치, 애플리케이션 Dockerfile 경로 등의 설정을 조정할 수 있습니다.
인증 안내 - “GitHub 저장소를 Starlight Hyperlift에 연결하는 방법” 가이드로 이동합니다.
애플리케이션 로그 - 애플리케이션 실행 중 수집된 로그가 여기에 표시됩니다.
연결- Hyperlift 구독에 설치된 활성 연결(도메인, SSL 인증서 등)을 확인할 수 있습니다.
자동 빌드
빌드가 수동 또는 자동으로 트리거될지 선택할 수도 있습니다.
자동 빌드 설정을 사용하면 지정한 브랜치에 코드를 푸시할 때마다 Hyperlift가 Dockerfile을 사용해 GitHub에서 앱을 자동으로 빌드하고 배포합니다.
애플리케이션 구성 단계에서 이를 활성화하려면, Hyperlift Manager 메뉴 > 애플리케이션 설정 > 애플리케이션 설정하기로 이동하세요. 여기서 자동 빌드를 켜거나 끌 수 있습니다:
“자동 빌드” 옵션이 비활성화(토글이 꺼짐)된 경우, 수동 빌드가 설정되며 자동 애플리케이션 업데이트는 이루어지지 않습니다.
추천 사항
Dockerfile에는 작고 효율적인 베이스 이미지를 사용하세요.
베이스 이미지 버전을 명확하게 태그하세요(예: python:3.12).
Starlight Hyperlift의 해당 메뉴에서 환경 변수를 설정하세요.
빌드 및 애플리케이션 로그를 모니터링하세요.