다음 지침은 다음 항목에만 적용됩니다. GAMS 슬롯 머신 서버 설치 및 구성. 해당 단계는 다음에서 수행되어야 합니다. 이러한 목적으로 사용되는 서버입니다. 꼭 확인해 주세요 계속하기 전에 GAMS 엔진을 설치했습니다. GAMS 슬롯 머신 서버 설치.
다음 지침은 다음 항목에만 적용됩니다. GAMS 슬롯 머신 서버 설치 및 구성. 해당 단계는 다음에서 수행되어야 합니다. 이러한 목적으로 사용되는 서버입니다. 꼭 확인해 주세요 계속하기 전에 GAMS 엔진을 설치했습니다. GAMS 슬롯 머신 서버 설치.
슬롯 머신 서버를 설치하려면 먼저 ZIP 파일을 다운로드하세요. 시작하는 데 필요한 모든 것이 포함되어 있습니다.여기.
일반적인 설치 지침은 다음과 같습니다. 그러나 설치가 매우 어렵다는 점을 명심하십시오. 설정에 따라 다릅니다. GAMS 슬롯 머신 서버 설정 일반적으로 시스템 관리자가 수행해야 합니다. 설치에 문제가 있으면 하지 마십시오. 주저하지 말고 메일로 문의해 주세요.support@gams.com.
GAMS 엔진은 현재 x86_64에서만 지원됩니다. Linux 배포판은 다음과 같습니다.Docker에서 지원함!
GAMS 슬롯 머신 애플리케이션은 나중에 다음 위치에 저장됩니다. 이 위치.
다음을 실행하여 슬롯 머신 Sever 설치./슬롯 머신-server install. 당신은 질문을 받게 될 것입니다 GAMS 엔진 호스트를 입력하고네임스페이스슬롯 머신 서버에서 사용됩니다.
기본 네임스페이스는글로벌. 당신은 할 수 있습니다 또한 GAMS에서 생성된 다른 네임스페이스도 지정합니다. 엔진. GAMS 엔진 연결을 변경할 수 있습니다. 자동 생성된 정보를 수정하여 언제든지 정보를 확인할 수 있습니다..env내부에 있는 파일 miro_server 디렉터리입니다. 다음 환경 변수를 설정해야 합니다:
| 환경 변수 이름 | 환경 변수 값 | 예 |
|---|---|---|
| GMS_MIRO_ENGINE_HOST | 엔진의 IP 주소 및 포트/DNS | https://mydomain.com/api |
| GMS_MIRO_ENGINE_NS | 슬롯 머신 서버에서 사용할 엔진 네임스페이스 | miro_server |
다음의 경우 슬롯 머신 서버를 다시 시작해야 합니다..env변경되었습니다.
또한 슬롯 머신를 사용할 것인지 묻는 메시지가 표시됩니다. 인증 서비스가 있거나 없는 서버, 즉 사용자가 기존 GAMS로 로그인해야 하는지 여부 엔진 계정(기본값) 또는 유효한 URL은 앱에 무료로 액세스할 수 있어야 합니다. 읽기 사용자 관리에 대해 자세히 알아보기여기.
설치 스크립트는 다음 여부를 알려줄 것입니다. 설치 성공 여부입니다.
GAMS 슬롯 머신 서버가 설치되면 다음을 시작할 수 있습니다 그것을 통해
GAMS 슬롯 머신 서버는 이제 포트 8080에서 수신 대기하며슬롯 머신 서버 REST API켜짐 포트 8081. 다음을 수행하는 모든 GAMS 엔진 사용자로 로그인할 수 있습니다. 어느 정도 권한이 있거나 다음에서 모델을 볼 수 있습니다. 지정된 네임스페이스. 권한이 없는 사용자 네임스페이스는 사용자 그룹을 볼 수 있으면 모델을 볼 수 있습니다. 해당 모델과 연관되어 있습니다.
추가된 슬롯 머신 애플리케이션에 직접 접근하려면 슬롯 머신 서버로 이동하세요./app_direct/<appId>, 여기서appId은 기본 GM의 소문자 이름입니다. 기본값은 파일입니다.
중지실행 중인 GAMS 슬롯 머신 서버 인스턴스를 중지하려면 다음을 실행하세요.
다시 시작하려면 다음을 실행하세요.
다음을 변경할 경우 주의하세요docker-compose.yml이 변경사항은 파일에 포함되지 않습니다. 이 명령을 실행한 후에 반영됩니다. 그러한 경우에는 다음을 수행하십시오../슬롯 머신-server stop그리고./슬롯 머신-server start.
업데이트GAMS 슬롯 머신 서버를 최신 버전으로 업데이트하려면 다음을 실행하세요.
이렇게 하면 다음에서 새 이미지를 가져옵니다.도커 허브그리고 발사하세요. 새 이미지만 가져오려면 다음을 실행하세요.
GAMS 슬롯 머신 서버를 백업하려면 다음을 실행하세요.
이것은 새로운 것을 생성합니다./backup디렉토리의 현재 디렉토리. 슬롯 머신 백업은 두 개의 파일로 구성됩니다../backup/dump_db_$BACKUP_TIME.gz그리고./backup/dump_miro_server_$BACKUP_TIME.gz슬롯 머신 PostgreSQL 데이터베이스 백업과 각각 현재 디렉토리입니다.백업_시간다음을 포함하는 타임스탬프입니다. 형식:%d-%m-%Y_%H_%M_%S.
복원(Linux에만 해당)다음으로 생성된 백업에서 GAMS 슬롯 머신 서버를 복원하려면./슬롯 머신-서버 백업명령, 먼저 압축을 풀어주세요 새로운miro_server.zip그리고 다음으로 이동합니다.miro_server디렉토리. 다음으로,백업백업 파일이 있는 디렉토리 이 디렉토리를 실행하고
어디에서백업_시간다음의 백업 타임스탬프입니다. 형식:%d-%m-%Y_%H_%M_%S(예:01-04-2022_19_13_412022년 4월 1일, 19:13:41).
제거관련된 모든 데이터를 포함하여 GAMS 슬롯 머신 서버를 제거하려면 서버에서 이를 사용하여 실행하세요.
추가로, 당신은 당신이 있는 디렉토리를 제거할 수 있습니다 GAMS 슬롯 머신의 구성 파일을 추출했습니다. 서버.
슬롯 머신 서버를 설정한 후 일부 기본 구성 만들 수 있습니다. 여기에는 무엇보다도 로그인 화면 로고 또는 인증 조정 방법.
대부분의 설정은 다음에서 수행할 수 있습니다.데이터/application.yml파일miro_server디렉토리. 꼭 머물러야 한다는 점 참고하세요 파일의 YAML 형식을 사용합니다. 그렇지 않은 것도 중요합니다. 다음 이외의 파일을 조정한 경우 설정. 변경 사항은 기능에 직접적인 영향을 미칩니다. 슬롯 머신 서버!
다음 설정은 다음 설정에서 이루어질 수 있습니다.데이터/application.yml파일:
이 전체 색상 테마 설정은 처음에 다음에 적용됩니다. 모든 앱, 앱 개요 페이지 및 로그인 화면. 개별적으로 다른 색상 테마를 설정할 수 있습니다. 전역 설정을 재정의하는 각 앱. 읽기 앱 환경에 대해 자세히 알아보기여기.
당신이 만든 경우슬롯 머신 서버용 맞춤 테마, 다운로드한 위치colors_custom.css새로 생성된 파일 폴더 안에miro_server/data, 예:miro_server/data/css/colors_custom.css. 지금 이 스타일 시트를에 지정하십시오.docker-compose.yml'proxy.volumes' 아래의 파일:
프록시:
이미지: gams/슬롯 머신-proxy:최신
포트:
- 8080:8080
볼륨:
+ - ./data/css/colors_custom.css:/home/miroproxy/templates/2col/assets/css/themes/colors_custom.css
- ./data:/home/miroproxy/data
콜론 앞의 경로 (./data/css/colors_custom.css)은 다음을 가리킵니다. 사용자 정의 테마 CSS 파일. 두 번째 경로는 다음을 가리킨다. 컨테이너 내부의 파일은 덮어썼습니다.
사전 정의된 사용자 정의 외에도 테마를 포함할 수도 있습니다.맞춤형 CSS파일.
이 설정을 사용하면 다음에 대한 전역 언어를 설정할 수 있습니다. 배포된 모든 슬롯 머신 앱. 현재 언어는 영어('en'), 중국어('cn') 및 독일어('de'). 이 전역 언어 설정은 처음에 모든 앱에 적용됩니다. 여전히 다른 설정을 할 수 있습니다 각 앱마다 개별적으로 언어를 사용합니다. 전역 설정. 이를 통해 앱을 호스팅할 수 있습니다. 다른 언어. 자세히 알아보기개인의 언어를 변경하는 방법 앱.
파일(예: 앱)의 최대 크기(MB) 관리자 패널 또는 슬롯 머신 앱의 데이터) 업로드 중입니다.
슬롯 머신 앱은 다음과 같습니다.서명됨개발자의 신뢰성을 보장합니다. 이 실수로 앱을 가져오는 것을 방지할 수 있습니다. 악의적인 행위자에 의해 조작되었습니다. 작성자: 기본적으로 슬롯 머신 Server는 모든 앱을 가져옵니다. 서명 없음 검증이 시행됩니다. 서명을 활성화하려면 확인하려면 이 옵션을 다음으로 설정하세요.사실. 슬롯 머신는 다음과 같은 경우에 오류를 발행합니다. 귀하가 서명하지 않은 앱을 가져오려고 합니다. 신뢰할 수 있는 개발자. 모든 공개 키를 저장해야 합니다. (PEM 형식) 귀하가 신뢰하는 개발자의 디렉토리:miro_server/data/known_keys.
기본적으로 권한이 없는 사용자가 슬롯 머신 서버 네임스페이스는 슬롯 머신 애플리케이션을 엽니다. 읽기 전용 모드로 시작됩니다. 이는 GAMS가 상호 작용 섹션과 "해결" 버튼은 숨겨져 있습니다. 또한 샌드박스 시나리오는 저장 또는 삭제되었습니다. 이 동작을 비활성화하려면 다음을 설정하십시오. 옵션:참.
인증이 비활성화된 경우에만 관련됨 (proxy.authentication: 없음): 읽기 전용 모드를 활성화합니다(GAMS 상호작용 섹션 및 해결 버튼 숨겨진 및 샌드박스 시나리오 저장/삭제할 수 없습니다.) 하지 않는 것이 좋습니다 줘익명 사용자이 설정이 다음과 같은 경우 GAMS 엔진의 모든 권한 활성화되었습니다.
인증 없이 슬롯 머신 서버를 실행할 때 모델은 사용자가 다음과 같은 경우에만 문제를 해결/GAMS 엔진에 제출할 수 있습니다. 실행 권한이 있는 것이 사용됩니다. 자격 증명 이 사용자는에 제공되어야 합니다..env파일의miro_server디렉토리. 이에 대해 자세히 알아보기여기.
인증을 위해 OpenID Connect를 설정하려면 몇 가지 추가 매개변수를 설정해야 합니다. 읽기여기더 많은 정보를 원하시면.
인증:
이미지: 슬롯 머신-auth
빌드: ./auth/
포트:
- 8081:1234
환경:
+ SCRIPT_NAME: /miroapps
포트: 1234
기타 설정:
슬롯 머신 서버의 CSS 스타일을 사용자 정의할 수 있습니다. 에 대한 예를 들어 로그인 페이지를 다시 디자인하거나 적용할 수 있습니다. 로그인 및 앱 개요에 대한 기타 사용자 정의 스타일 화면:
이 목적을 위해서는 사용자 정의 CSS 파일이 제공되어야 합니다 슬롯 머신 서버가 시작될 때. 이렇게 하려면 새 아래의 'CSS' 디렉토리miro_server/data, 여기서 사용자 정의 CSS(예:miro_server/data/css/styles.css). 지금 이 스타일 시트를에 지정하십시오.docker-compose.yml'proxy.volumes' 아래의 파일:
프록시:
이미지: gams/슬롯 머신-proxy:최신
포트:
- 8080:8080
볼륨:
+ - ./data/css/styles.css:/home/miroproxy/templates/2col/assets/css/styles.css
- ./data:/home/miroproxy/data
콜론 앞의 경로 (./data/css/styles.css)이 귀하를 가리킵니다. 사용자 정의 CSS 파일. 두 번째 경로는 파일을 가리킵니다. 덮어쓰게 될 컨테이너 내부에 있습니다.
슬롯 머신 서버에서 사용하는 원본 스타일시트는 다음과 같습니다. 찾았습니다여기.
모든 변경 사항은 다음 이후에 적용됩니다.슬롯 머신 서버 재시작. 다음을 변경하는 경우docker-compose.yml당신이 수행해야 할 구성./슬롯 머신-server stop그리고./슬롯 머신-server start.
GAMS 슬롯 머신 서버는 OpenID Connect를 다음과 같이 지원합니다. 인증 방법. OpenID Connect를 사용하려면,프록시.인증키(데이터/application.yml파일)을 다음으로 설정해야 합니다.openid. 또한 다음 매개변수 지정해야 합니다:
Google의 예는 아래에서 찾을 수 있습니다.
프록시:
[...]
인증: openid
공개 ID:
인증 URL: https://accounts.google.com/o/oauth2/v2/auth
토큰 URL: https://oauth2.googleapis.com/token
jwks-url: https://www.googleapis.com/oauth2/v3/certs
로그아웃 URL: https://www.google.com/accounts/Logout?continue=https://appengine.google.com/_ah/logout?continue=http%3A%2F%2Fwww.yourmiroerver.com%2Flogout-success
클라이언트 ID: ***
클라이언트 비밀: ***
교체하는 것을 잊지 마세요www.yourmiroerver.com에로그아웃-URL필드를 슬롯 머신의 URL로 바꿉니다. 서버 인스턴스.
마찬가지로, Microsoft Entra ID의 예:
프록시:
[...]
인증: openid
공개 ID:
인증 URL: https://login.microsoftonline.com/<your-tenant-id>/oauth2/v2.0/authorize
토큰 URL: https://login.microsoftonline.com/<your-tenant-id>/oauth2/v2.0/token
jwks-url: https://login.microsoftonline.com/<your-tenant-id>/discovery/v2.0/keys
로그아웃 URL: https://login.microsoftonline.com/common/oauth2/v2.0/logout?post_logout_redirect_uri=http%3A%2F%2Fwww.yourmiroserver.com%2Flogout-success
클라이언트 ID: ***
클라이언트 비밀: ***
또한 GAMS 엔진 서버는 다음과 같아야 합니다.동일한 OpenID Connect 공급자를 사용하도록 구성됨, 슬롯 머신 Server에 로그인하려는 모든 사용자는 또한 이 ID 공급자를 사용하세요. 참고하세요클라이언트 ID슬롯 머신 서버에 지정했습니다. 구성을 추가 목록에 추가해야 합니다. 클라이언트 ID(extra_client_ids67092_67132
OpenID Connect 공급자에 등록해야 합니다. 다음 리디렉션 URI:http(s)://www.yourmiroserver.com/login/oauth2/code/miroserver.
슬롯 머신 응용 프로그램에 추가 패키지가 필요한 경우, 연장해야 합니다.슬롯 머신 UI 도커 이미지. 추가 패키지를 추가하면 됩니다. 사용자 정의 렌더러에서 파일에 필요함추가_패키지내부에 위치miro_server디렉토리. 각 패키지 이름은 새 줄에 있어야 합니다. 한 번 모든 패키지가 이 파일에 추가되고 실행됩니다.
추가 패키지로 인해 버전이 달라질 수 있다는 점에 유의하십시오. 슬롯 머신에서 내부적으로 사용하는 패키지와 충돌합니다. 우리 따라서 추가 개수를 유지하는 것이 좋습니다. 패키지를 최소화하세요.
역방향 프록시 뒤에서 GAMS 슬롯 머신 서버를 실행하는 것이 좋습니다 같은nginx. 파일에서 예시 구성을 찾을 수 있습니다.슬롯 머신conf내부에 위치miro_server에 언급된 디렉토리 설치 지침. 이 구성을 적용하려면 간단히 구성 위치에 복사하십시오. nginx(예:sudo cp 슬롯 머신conf /etc/nginx/conf.d/). 참고 나중에 다음을 사용하여 nginx를 다시 로드해야 합니다.sudo nginx -s 다시 로드.
같은 호스트에 GAMS 엔진과 슬롯 머신 서버 호스팅귀하가 슬롯 머신 Engie 및 슬롯 머신 서버를 호스트할 때 동일한 호스트의 경우 nginx 구성을 병합해야 합니다. GAMS 엔진과 슬롯 머신 서버 모두. 결과/etc/nginx/conf.d/슬롯 머신conf다음과 같이 보일 수 있습니다 다음과 같습니다:
GAMS 엔진과 슬롯 머신 서버가 모두 동일한 호스트에서 실행되지만 GAMS 엔진 호스트는 그렇지 않습니다.로컬호스트. TLS의 경우 포트/인증서 정보 등이 사용되는 경우 여기에도 추가해야 합니다. 당신이 이에 대한 도움이 필요하시면 저희에게 연락해주세요. Nginx는 다음과 같아야합니다. 구성이 변경된 경우 다시 로드됩니다.sudo nginx -s 다시 로드.
이외의 경로에서 슬롯 머신 서버를 호스팅하려는 경우 루트인 경우 파일의 컨텍스트 경로를 변경해야 합니다.데이터/application.yml따라서 (항목server.servlet.context-path).
SELinux가 활성화된 경우(예: CentOS/RHEL) nginx 서버가 프록시를 사용하도록 허용해야 할 수도 있습니다. 업스트림 슬롯 머신 서버 호스트. 다음을 실행하여 그렇게 할 수 있습니다:setsebool -P httpd_can_network_connect 1.
만약에인스턴스가 슬롯 머신 서버와 동일한 시스템에서 실행 중입니다. 고려해야 할 몇 가지 사항이 있습니다. 다음 예 슬롯 머신와 Engine을 실행하기 위한 설치 과정을 보여줍니다. 새로 설치된 Ubuntu 24.04 서버에서.
슬롯 머신 서버 설정에는 GAMS 엔진이 필요하므로 위치를 지정하려면 먼저 설치해야 합니다.
우리는 루트 URL을 전달하도록 Nginx를 구성합니다 https://my-슬롯 머신com/ 슬롯 머신 서버 및 https://my-슬롯 머신com/engine에서 GAMS 엔진으로 이동합니다. 에 따라 사용되는 Linux 배포판에 따라 배포 위치와 방법이 다릅니다. 구성을 저장해야 합니다. 이 예에서는 우분투 20.04.
동일한 환경에서 엔진과 슬롯 머신 서버를 실행하는 것 외에 여러 개의 슬롯 머신 서버를 가질 수도 있습니다. 거기에서 실행되는 인스턴스. 이는 유용할 수 있습니다. 예를 들어 일부 슬롯 머신 애플리케이션을 소개해야 한다면 다른 것들은 등록된 사용자만 액세스할 수 있어야 합니다. 사용자. 다음 예는 다음을 기반으로 합니다.이전 구성그리고 또 다른 슬롯 머신 서버 인스턴스를 추가합니다. 이것은 https://my-슬롯 머신com/server_2/에서 액세스할 수 있습니다.
위치 /서버_2
프록시패스 http://127.0.0.1:8090;
프록시_http_버전 1.1;
Proxy_set_header 업그레이드 $http_upgrade;
Proxy_set_header 연결 "업그레이드";
Proxy_read_timeout 600초;
Proxy_redirect 꺼짐;
Proxy_set_header 호스트 $http_host;
Proxy_set_header X-Real-IP $remote_addr;
Proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
Proxy_set_header X-Forwarded-Proto $scheme;
위치 /server_2/api/
프록시패스 http://127.0.0.1:8096;
Proxy_redirect 꺼짐;
Proxy_set_header 호스트 $http_host;
Proxy_set_header X-Real-IP $remote_addr;
Proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
Proxy_set_header X-Forwarded-Proto $scheme;
요청/서버_2포트로 전달됨8090또한 우리가 지정한docker-compose.yml그리고data_raw/application.yml파일. 슬롯 머신 REST API는 다음을 통해 액세스할 수 있습니다./server_2/api. 포트는 다음에 해당합니다. 하나는 다음에서 사용됨docker-compose.yml.