alf.io 다운로드 - alf.io 소스 코드 다운로드

alf.io

자바 소스 코드

2.0-M5

다운로드

alf.io

오픈 소스 티켓 예약 시스템.

Alf.io([ˈalfjo])는 고객의 개인 정보 보호, 보안 및 공정한 가격 정책에 관심이 있는 이벤트 주최자를 위해 개발된 무료 오픈 소스 이벤트 참석 관리 시스템입니다.

전제 조건
스프링 프로파일
개발 모드에서 실행
alf.io에 기여
업데이트할 종속성을 확인하세요.
Docker 컨테이너 실행
기여자

전제 조건

alf.io를 빌드하고 실행하려면 Java 버전 17 (예: Oracle, OpenJDK 또는 기타 배포판)을 설치해야 합니다. 빌드 프로세스에는 JDK가 필요합니다.

Postgresql 버전 10 이상.

또한 테이블을 생성하고 사용하는 데이터베이스 사용자는 "SUPERUSER"가 아니어야 합니다. 그렇지 않으면 행 보안 정책 검사가 적용되지 않습니다.

메모

Alf.io v2에 대한 작업이 시작되었으므로 이 분기에는 불안정 하고 테스트되지 않은 코드가 포함될 수 있습니다. alf.io를 직접 빌드하고 배포하려면 릴리스 버전부터 시작하세요.

스프링 프로파일

다음과 같은 스프링 프로파일이 있습니다.

dev : 개발 모드 활성화
spring-boot : spring-boot에 의해 시작될 때 추가됨
demo : 데모 모드를 활성화하면 관리자 계정이 즉시 생성됩니다.
disable-jobs : 작업 비활성화
jdbc-session : 데이터베이스에 사용자 세션을 유지합니다.

개발 모드에서 실행

Gradle 빌드

이 빌드에는 Gradle 래퍼 사본이 포함되어 있습니다. 프로젝트를 빌드하기 위해 시스템에 Gradle을 설치할 필요는 없습니다. 예를 들어 적절한 작업과 함께 래퍼를 실행하기만 하면 됩니다.

 ./gradlew clean

여러 프로필로 실행

명령줄에서 다음과 같은 프로젝트 속성을 지정해야 합니다.

 ./gradlew -Pprofile=dev :bootRun

로컬 "bootRun" 작업에는 다음과 같은 전제 조건이 있습니다.

localhost:5432에서 실행 중인 PostgreSQL(버전 10 이상) 인스턴스
비밀번호가 있는 postgres 사용자: 비밀번호
alfio 라는 데이터베이스

 docker run -d --name alfio-db -p 5432:5432 -e POSTGRES_PASSWORD=password -e POSTGRES_DB=alfio --restart unless-stopped postgres

일단 시작되면 alf.io는 데이터베이스에 필요한 모든 테이블을 생성하고 http://localhost:8080/admin에서 사용할 수 있습니다. 기본 사용자 이름 admin 과 콘솔에 인쇄된 비밀번호를 사용하여 로그인할 수 있습니다.

다음을 실행하여 지원되는 모든 Gradle 작업 목록을 얻을 수 있습니다.

 ./gradlew tasks --all

다음 파일을 생성하고 한 줄에 하나의 속성을 입력하여 추가 시스템 속성(필요한 경우)을 구성할 수 있습니다.

 vi custom.jvmargs

이 파일에는 민감한 정보(예: Google 지도 개인 API 키)가 포함될 수 있으므로 git에서 자동으로 무시됩니다.

디버그용

custom.jvmargs에 -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 사용하여 새 줄을 추가합니다.

alf.io에 기여

Gradle 프로젝트를 Intellij와 Eclipse로 가져오는 것이 모두 작동합니다.

참고 사항 :

이 프로젝트는 Project Lombok을 사용합니다. IDE에 통합하려면 해당 Lombok 플러그인을 설치해야 합니다.
이 프로젝트는 TestContainers를 사용하여 실제 PostgreSQL 데이터베이스에 대한 통합 테스트를 실행합니다. 구성이 요구사항을 충족하는지 확인하세요.

Podman으로 TestContainers를 구성하는 방법(Fedora 34)

TestContainers는 컨테이너 관리를 위해 Docker 소켓을 기대하므로 다음을 수행해야 합니다(자세한 내용은 원래 문제 참조).

2 환경을 정의합니다. 변하기 쉬운:

 export TESTCONTAINERS_RYUK_DISABLED=true
export DOCKER_HOST=unix:///run/user/1000/podman/podman.sock

그리고 다른 콘솔에서 실행하세요:

 podman system service -t 0

참고할 사항:

알 수 없는 이유로 Podman이 누락된 이미지를 처음 다운로드하면 테스트 컨테이너가 실패합니다. 한 번 더 실행하면 작동할 것입니다.
이론상으로는 systemd+소켓 활성화를 사용하면 서비스가 자동으로 시작되어야 하지만 현재는 이를 작동시킬 수 없습니다.

업데이트할 종속성을 확인하세요.

./gradlew dependencyUpdates

Docker 컨테이너 실행

컨테이너 이미지는 https://hub.docker.com/r/alfio/alf.io/tags에서 사용할 수 있습니다.

alf.io는 Docker Compose( 개발 모드 )를 사용하여 실행할 수도 있습니다.

 docker-compose up

Docker Compose를 사용하여 프로덕션에서 alf.io를 실행하는 것은 공식적으로 지원되지 않습니다. 그러나 그렇게 하기로 결정한 경우 몇 가지 사항을 변경해야 합니다.

docker-compose.yml 파일에서 alfio 서비스의 주석 처리를 제거하세요.
.env 파일에서 서비스에 대한 사용자 및 비밀번호를 확인하세요.
SSL 종료 처리(예: tutum/haproxy 등을 사용) 443 -> 8080

alf.io 애플리케이션 테스트

alfio 로그 확인: docker logs alfio
관리자 비밀번호를 안전한 곳에 복사하세요
Docker 컨테이너의 IP 가져오기: (Mac/Windows에서만, Linux에서는 프록시가 공용 IP에 직접 바인딩됩니다.)
- Mac/Windows의 boot2docker IP
https://DOCKER_IP/admin 에서 브라우저를 엽니다.
사용자 admin과 방금 복사한 비밀번호를 입력하세요.

alfio/alf.io 도커 이미지의 새 버전을 생성합니다.

애플리케이션 및 Dockerfile 빌드

 ./gradlew distribution

또는 Docker( 실험적 )를 사용할 수 있습니다.

 docker run --rm -u gradle -v "$PWD":/home/gradle/project -w /home/gradle/project gradle:7.0.0-jdk11 gradle --no-daemon distribution -x test

현재 위 명령은 자동화된 테스트를 실행하지 않고 빌드를 수행한다는 점에 유의하세요. 자신의 책임하에 사용하십시오.

도커 이미지를 생성합니다:

 docker build -t alfio/alf.io ./build/dockerize

포함된 AppleWWDRCAG4.cer 정보

src/main/resources/alfio/certificates/AppleWWDRCAG4.cer의 인증서를 https://github.com/ryantenney/passkit4j#usage 기능을 위해 가져왔습니다. 2030년 10월 12일(YYYY-MM-DD - https://www.apple.com/certificateauthority/ 기준)에 만료됩니다.

기여자

코드 기여자

이 프로젝트는 기여하는 모든 사람들 덕분에 존재합니다.

번역 기여자(POEditor)

POEditor에서 우리를 도와준 번역가들에게도 큰 "감사합니다"가 전달됩니다.

(명시적인 동의를 받은 경우에만 전체 이름/프로필을 표시합니다)

언어	이름	Github	지저귀다
네덜란드어(nl)	맛히스
터키어(tr)	딜렉
스페인어(es)	마리오 바로나	@mvarona	@MarioVarona
스페인어(es)	세르지 알마르	@살마르	@sergialmar
스페인어(es)	예레미야스
불가리아어(bg)	마틴 제코프	@Martin03	@MartensZone
포르투갈어(pt)	휴고
스웨덴어(sv)	요한
루마니아어(ro)	다니엘
폴란드어(pl)	파웰
덴마크어(다)	수네