프라이빗 자동화 허브 설치 및 업그레이드
프라이빗 자동화 허브 설치 또는 업그레이드
초록
머리말
Private Automation Hub를 설치하거나 Red Hat Enterprise Linux (RHEL) 8.4 이상에서 새 버전으로 업그레이드하거나 유효한 Red Hat Ansible Automation Platform 서브스크립션을 사용하여 RHEL 9 이상 가상 또는 물리적 머신으로 업그레이드할 수 있습니다.
보다 포괄적 수용을 위한 오픈 소스 용어 교체
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.
Red Hat 문서에 관한 피드백 제공
Red Hat의 기술 콘텐츠에 대한 귀하의 피드백에 감사드리며, 귀하가 생각하는 것을 알려 주시기 바랍니다. 주석을 추가하거나, 인사이트를 제공하거나, 오타를 수정하거나, 질문을 하려면 문서에서 직접 이 작업을 수행할 수 있습니다.
Red Hat 계정이 있어야 하며 고객 포털에 로그인해야 합니다.
고객 포털에서 문서 피드백을 제출하려면 다음을 수행하십시오.
- 다중 페이지 HTML 형식을 선택합니다.
- 문서 오른쪽 상단에 있는 피드백 버튼을 클릭합니다.
- 피드백을 제공하려는 텍스트 섹션을 강조 표시합니다.
- 강조 표시된 텍스트 옆에 있는 피드백 추가 대화 상자를 클릭합니다.
- 페이지 오른쪽에 있는 텍스트 상자에 피드백을 입력한 다음 제출을 클릭합니다.
피드백을 제출할 때마다 추적 문제가 자동으로 생성됩니다. Submit 을 클릭한 후 표시되는 링크를 열고 문제 모니터링을 시작하거나 의견을 더 추가합니다.
1장. 시스템 요구 사항
프라이빗 자동화 허브 인스턴스를 설치하려면 다음이 필요합니다.
표 1.1. 시스템 요구 사항
| 필수 항목 | |
|---|---|
| 서브스크립션 | 유효한 Red Hat Ansible Automation Platform |
| OS | RHEL 8.4 이상 64비트(x86) 또는 RHEL 9.0 이상 64비트(x86) |
| Ansible | 버전 2.14 필요 |
| RAM | 최소 8GB |
| CPU | 최소 2개 |
| 디스크 | 60GB 전용 하드 디스크 공간 저장된 컬렉션의 크기에 따라 다름 |
| 브라우저 | 현재 지원되는 Mozilla Firefox 또는 Google Chrome 버전 |
| 데이터베이스 | PostgreSQL 버전 13 |
동일한 노드에 Ansible Automation Platform 및 프라이빗 자동화 허브 인스턴스를 설치할 수 없습니다. 인벤토리 파일은 Ansible Automation Platform 및 자동화 허브의 설치를 처리할 수 있습니다. 이러한 지침은 Ansible Automation Platform 설치에만 해당합니다.
2장. 온라인 또는 오프라인 설치
Red Hat Enterprise Linux 환경 인터넷 연결을 기반으로 프라이빗 자동화 허브를 설치하는 데 필요한 Ansible Automation Platform 설치 관리자를 선택합니다. 다음 시나리오를 검토하고 요구 사항을 충족하는 Ansible Automation Platform 설치 프로그램을 확인합니다.
Red Hat 고객 포털에서 Ansible Automation Platform 설치 프로그램에 액세스하려면 유효한 Red Hat 고객 계정이 있어야 합니다.
인터넷 액세스로 설치
Red Hat Enterprise Linux 환경이 인터넷에 연결된 경우 Ansible Automation Platform 설치 프로그램을 사용하여 프라이빗 자동화 허브를 설치합니다. 인터넷 액세스를 사용하여 설치하면 최신 필수 리포지토리, 패키지 및 종속성이 검색됩니다.
- Red Hat Ansible Automation Platform 다운로드 페이지로 이동합니다.
- Ansible Automation Platform <latest-version> 설정에 대해 지금 다운로드를 클릭합니다.
파일을 추출합니다.
$ tar xvzf ansible-automation-platform-setup-<latest-version>.tar.gz
인터넷 액세스없이 설치
인터넷에 액세스할 수 없는 경우 Ansible Automation Platform Bundle 설치 프로그램을 사용하여 프라이빗 자동화 허브를 설치하거나 온라인 리포지토리와 별도의 구성 요소 및 종속 항목을 설치하지 않도록 합니다. Red Hat Enterprise Linux 리포지토리에 대한 액세스는 여전히 필요합니다. 다른 모든 종속 항목은 tar 아카이브에 포함되어 있습니다.
- Download Red Hat Ansible Automation Platform.
- Ansible Automation Platform <latest-version> Setup Bundle 에 대해 지금 다운로드를 클릭합니다.
파일을 추출합니다.
$ tar xvzf ansible-automation-platform-setup-bundle-<latest-version>.tar.gz
3장. 인벤토리 파일 편집
인벤토리 파일을 편집하여 자동화 허브 설치를 지정하고 필요한 매개변수를 업데이트합니다.
설치 프로그램으로 이동합니다.
[bundled 설치 프로그램]
$ cd ansible-automation-platform-setup-bundle-<latest-version>
[온라인 설치 프로그램]
$ cd ansible-automation-platform-setup-<latest-version>
-
텍스트 편집기로
인벤토리파일을 엽니다. 인벤토리파일 매개 변수를 편집하여 자동화 허브 호스트 설치만 지정합니다. 다음 예제를 참조하십시오.-
[automationcontroller]인벤토리 정보를 비워 둡니다. [automationhub]그룹 호스트 정보를 추가합니다.참고[automationhub]호스트에 연결할 수 있는 IP 주소를 제공하여 사용자가 다른 노드에서 프라이빗 자동화 허브에서 콘텐츠를 동기화할 수 있도록 합니다.설치 사양에 따라
automationhub_admin_password및automation_pg_password및 추가 매개변수 값을 업데이트합니다.예제
[automationcontroller] [automationhub] <reachable-ip> ansible_connection=local [all:vars] automationhub_admin_password= <PASSWORD> automationhub_pg_host='' automationhub_pg_port='' automationhub_pg_database='automationhub' automationhub_pg_username='automationhub' automationhub_pg_password=<PASSWORD> automationhub_pg_sslmode='prefer' # The default install will deploy a TLS enabled Automation Hub. # If for some reason this is not the behavior wanted one can # disable TLS enabled deployment. # # automationhub_disable_https = False # The default install will generate self-signed certificates for the Automation # Hub service. If you are providing valid certificate via automationhub_ssl_cert # and automationhub_ssl_key, one should toggle that value to True. # # automationhub_ssl_validate_certs = False # SSL-related variables # If set, this will install a custom CA certificate to the system trust store. # custom_ca_cert=/path/to/ca.crt # Certificate and key to install in Automation Hub node # automationhub_ssl_cert=/path/to/automationhub.cert # automationhub_ssl_key=/path/to/automationhub.key
-
3.1. Red Hat Single Sign-On 환경에 자동화 허브 연결
자동화 허브를 Red Hat Single Sign-On 설치에 연결하려면 설치 프로그램 설정 스크립트를 실행하기 전에 인벤토리 파일에서 인벤토리 변수를 구성합니다.
Ansible Automation Platform에서 관리하는 Red Hat Single Sign-On 설치에 연결할 때 외부 Red Hat Single Sign-On 설치에 연결할 때와 다른 변수 세트를 구성해야 합니다.
3.1.1. 자동화 허브를 Red Hat Single Sign-On 인스턴스에 연결하기 위한 인벤토리 파일 변수
자동화 허브와 Red Hat Single Sign-On을 처음 설치하는 경우 또는 기존 Ansible Automation Platform에서 Red Hat Single Sign-On을 관리하는 기존 Ansible Automation Platform이 있는 경우 Ansible Automation Platform의 변수를 Red Hat Single Sign-On으로 구성하십시오.
자동화 허브를 설치하고 외부적으로 관리되는 기존 Red Hat Single Sign-On 인스턴스에 연결하려면 외부적으로 관리되는 Red Hat Single Sign-On의 변수를 구성합니다.
이러한 인벤토리 변수에 대한 자세한 내용은 Red Hat Ansible Automation Platform 설치 가이드의 Ansible 자동화 허브 변수를 참조하십시오.
Ansible Automation Platform 관리 및 외부 Red Hat Single Sign-On 모두에 대해 다음 변수를 구성할 수 있습니다.
| Variable | 필수 또는 선택 사항 |
|---|---|
|
| 필수 항목 |
|
| 선택 사항 |
|
| 선택 사항 |
|
| 선택 사항 |
|
| 선택 사항 |
|
| 선택 사항 |
|
| 선택 사항 |
|
| 선택 사항 |
Ansible Automation Platform 관리 Red Hat Single Sign-On에만 대해 다음 변수를 구성할 수 있습니다.
| Variable | 필수 또는 선택 사항 |
|---|---|
|
|
|
|
| 선택 사항 |
|
| 선택 사항 |
|
| 선택 사항 |
다음 변수는 외부 Red Hat Single Sign-On에만 구성할 수 있습니다.
| Variable | description |
|---|---|
|
| 필수 항목 |
4장. 설정 스크립트를 사용하여 자동화 허브 설치
적절한 인벤토리 변수를 구성한 후 설치 프로그램 설정 스크립트를 실행합니다.
4.1. 설정 스크립트 실행
프라이빗 자동화 허브 설치에 필요한 매개변수를 사용하여 인벤토리 파일 업데이트를 완료하면 설정 스크립트를 실행할 수 있습니다.
setup.sh스크립트를 실행하여 설치를 시작합니다.$ ./setup.sh
4.2. Red Hat Single Sign-On 연결 확인
설치 프로그램은 Red Hat Single Sign-On 변수를 사용하여 Keycloak 영역 및 클라이언트를 설정합니다.
기존 Red Hat Single Sign-On 설치에 성공적으로 연결되어 있는지 확인하려면 settings.py 에 Red Hat Single Sign-On 호스트 정보, 영역 이름, 키, 시크릿이 포함되어 있는지 확인합니다.
5장. 설치 확인
설치가 완료되면 다음 단계를 통해 프라이빗 자동화 허브가 성공적으로 설치되었는지 확인할 수 있습니다.
- 프라이빗 자동화 허브로 이동합니다.
-
인벤토리파일에 설정한 관리자 인증 정보로 로그인합니다.
이제 프라이빗 자동화 허브가 초기 구성을 사용할 준비가 되었습니다. 자세한 내용은 다음 관리 가이드를 참조하십시오.
6장. 최신 버전으로 업그레이드
Ansible Automation Platform 설치 번들 설치 프로그램을 사용하여 프라이빗 자동화 허브를 최신 버전으로 업그레이드할 수 있습니다. 프라이빗 자동화 허브를 설치할 때 구성된 인벤토리 파일을 사용하여 이 업그레이드를 수행합니다.
- Download Red Hat Ansible Automation Platform.
- Ansible Automation Platform <latest-version> Setup Bundle 에 대해 지금 다운로드를 클릭합니다.
파일을 추출합니다.
$ tar xvzf ansible-automation-platform-setup-bundle-<latest-version>.tar.gz
-
초기 설치의 구성 정보를
인벤토리파일에 복사합니다. setup.sh스크립트를 실행합니다.$ ./setup.sh
업그레이드 확인
서버 버전 정보를 검토하여 프라이빗 자동화 허브로 성공적으로 업그레이드되었는지 확인할 수 있습니다.
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 모음에서 ? 아이콘을 클릭합니다.
- 정보를 클릭합니다.
- 서버 버전이 업그레이드된 버전과 일치하는지 확인합니다.