Red Hat Ansible Automation Platform Operator 설치 가이드

1. Operators(운영자) InstalledOperators (설치된 Operator) 로 이동한 다음 Ansible Automation Platform Operator를 클릭합니다.
2. Automation Controller 탭을 찾은 다음 Create instance 를 클릭합니다.

1. 아래 템플릿에 따라 postgres_configuration_secret .yaml 파일을 생성합니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: external-postgres-configuration
     namespace: <target_namespace> 1
   stringData:
     host: "<external_ip_or_url_resolvable_by_the_cluster>" 2
     port: "<external_port>" 3
     database: "<desired_database_name>"
     username: "<username_to_connect_as>"
     password: "<password_to_connect_with>" 4
     sslmode: "prefer" 5
     type: "unmanaged"
   type: Opaque

   1

   보안을 생성할 네임스페이스입니다. 배포하려는 네임스페이스와 동일해야 합니다.

   2

   데이터베이스 노드의 확인 가능한 호스트 이름입니다.

   3

   외부 포트는 기본적으로 5432 로 설정됩니다.

   4

   변수 암호 값에는 배포, 백업 또는 복원 중에 문제가 발생하지 않도록 작은따옴표(', ") 또는 백슬래시(\)가 포함되지 않아야 합니다.

   5

   변수 sslmode 는 외부 데이터베이스에만 유효합니다. 허용되는 값은 prefer, disable, allow, require, verify-ca, verify-full 입니다.

2. oc create 명령을 사용하여 external-postgres-configuration-secret.yml 을 클러스터에 적용합니다.

   $ oc create -f external-postgres-configuration-secret.yml

3. AutomationController 사용자 정의 리소스 오브젝트를 생성할 때 사양의 보안을 지정합니다. 아래 예제를 따르십시오.

   apiVersion: awx.ansible.com/v1beta1
   kind: AutomationController
   metadata:
     name: controller-dev
   spec:
     postgres_configuration_secret: external-postgres-configuration

절차

1. 배포 네임스페이스의 기존 PVC를 나열합니다.

   oc get pvc -n <namespace>

2. 이전 배포 이름과 PVC 이름을 비교하여 이전 배포와 연결된 PVC를 확인합니다.

3. 이전 PVC를 삭제합니다.

   oc delete pvc -n <namespace> <pvc-name>

   == 추가 리소스

   • OpenShift Container Platform에서 Operator를 실행하는 방법에 대한 자세한 내용은 OpenShift Container Platform 제품 설명서 로 이동하여 OpenShift Container Platform에서 Operator 작업 가이드를 클릭합니다.

1. Operators(운영자) InstalledOperators 로 이동합니다.
2. Automation hub 항목을 찾은 다음 Create instance 를 클릭합니다.

1. Networking → Routes (경로) 로 이동합니다.
2. 위치 아래에서 자동화 허브 인스턴스의 URL을 클릭합니다.

1. 아래 템플릿에 따라 postgres_configuration_secret .yaml 파일을 생성합니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: external-postgres-configuration
     namespace: <target_namespace> 1
   stringData:
     host: "<external_ip_or_url_resolvable_by_the_cluster>" 2
     port: "<external_port>" 3
     database: "<desired_database_name>"
     username: "<username_to_connect_as>"
     password: "<password_to_connect_with>" 4
     sslmode: "prefer" 5
     type: "unmanaged"
   type: Opaque

   1

   보안을 생성할 네임스페이스입니다. 배포하려는 네임스페이스와 동일해야 합니다.

   2

   데이터베이스 노드의 확인 가능한 호스트 이름입니다.

   3

   외부 포트는 기본적으로 5432 로 설정됩니다.

   4

   변수 암호 값에는 배포, 백업 또는 복원 중에 문제가 발생하지 않도록 작은따옴표(', ") 또는 백슬래시(\)가 포함되지 않아야 합니다.

   5

   변수 sslmode 는 외부 데이터베이스에만 유효합니다. 허용되는 값은 prefer, disable, allow, require, verify-ca, verify-full 입니다.

2. oc create 명령을 사용하여 external-postgres-configuration-secret.yml 을 클러스터에 적용합니다.

   $ oc create -f external-postgres-configuration-secret.yml

3. AutomationHub 사용자 정의 리소스 오브젝트를 생성할 때 사양의 보안을 지정합니다. 아래 예제를 따르십시오.

   apiVersion: awx.ansible.com/v1beta1
   kind: AutomationHub
   metadata:
     name: hub-dev
   spec:
     postgres_configuration_secret: external-postgres-configuration

절차

1. 배포 네임스페이스의 기존 PVC를 나열합니다.

   oc get pvc -n <namespace>

2. 이전 배포 이름과 PVC 이름을 비교하여 이전 배포와 연결된 PVC를 확인합니다.

3. 이전 PVC를 삭제합니다.

   oc delete pvc -n <namespace> <pvc-name>

   == 추가 리소스

   • OpenShift Container Platform에서 Operator를 실행하는 방법에 대한 자세한 내용은 OpenShift Container Platform 제품 설명서 로 이동하여 OpenShift Container Platform에서 Operator 작업 가이드를 클릭합니다.

1. Operator에 대한 프로젝트를 생성합니다.

   oc new-project ansible-automation-platform

2. sub.yaml 이라는 파일을 생성합니다.

3. 다음 YAML 코드를 sub.yaml 파일에 추가합니다.

   ---
   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
     name: ansible-automation-platform
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: ansible-automation-platform-operator
     namespace: ansible-automation-platform
   spec:
     targetNamespaces:
       - ansible-automation-platform
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: ansible-automation-platform
     namespace: ansible-automation-platform
   spec:
     channel: 'stable-2.1'
     installPlanApproval: Automatic
     name: ansible-automation-platform-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   ---
   apiVersion: automationcontroller.ansible.com/v1beta1
   kind: AutomationController
   metadata:
     name: example
     namespace: ansible-automation-platform
   spec:
     replicas: 1

   이 파일은 ansible-automation-platform 네임스페이스를 ansible-automation-platform Operator에 가입하는 ansible-automation-platform -platform이라는 Subscription 오브젝트를 생성합니다.

   그런 다음 ansible-automation-platform 네임스페이스에서 example 이라는 AutomationController 오브젝트를 생성합니다.

   자동화 컨트롤러 이름을 예에서 변경하려면 sub.yaml 의 kind: AutomationController 섹션에서 name 필드를 편집하고 < automation_controller_name >을 사용하려는 이름으로 바꿉니다.

   apiVersion: automationcontroller.ansible.com/v1beta1
   kind: AutomationController
   metadata:
     name: <automation_controller_name>
     namespace: ansible-automation-platform

4. oc apply 명령을 실행하여 sub.yaml 파일에 지정된 오브젝트를 생성합니다.

   oc apply -f sub.yaml

절차

1. Operator → 설치된 Operator로 이동합니다.
2. rh-sso 프로젝트를 선택합니다.
3. Red Hat Single Sign-On Operator 를 선택합니다.
4. Red Hat Single Sign-On Operator 세부 정보 페이지에서 Keycloak 을 선택합니다.
5. 인스턴스 생성을 클릭합니다.

6. YAML 보기를 클릭합니다.

   기본 Keycloak 사용자 정의 리소스는 다음과 같습니다.

   apiVersion: keycloak.org/v1alpha1
   kind: Keycloak
   metadata:
     name: example-keycloak
     labels:
   	app: sso
     namespace: aap
   spec:
     externalAccess:
   	enabled: true
     instances: 1

7. 생성을클릭합니다.
8. 배포가 완료되면 이 인증 정보를 사용하여 관리 콘솔에 로그인할 수 있습니다.
9. 네임스페이스의 credential-<custom-resource >(example keycloak) 시크릿에서 관리자의 인증 정보를 찾을 수 있습니다.

절차

1. Operator → 설치된 Operator로 이동합니다.
2. Red Hat Single Sign-On Operator 프로젝트를 선택합니다.
3. Keycloak>-< 탭을 선택하고 Create Keycloak >-< 를 클릭합니다.

4. Keycloak>-& lt; 양식에서 YAML 보기 를 선택합니다. 다음과 같이 YAML 파일을 편집합니다.

   kind: KeycloakRealm
   apiVersion: keycloak.org/v1alpha1
   metadata:
     name: ansible-automation-platform-keycloakrealm
     namespace: rh-sso
     labels:
       app: sso
       realm: ansible-automation-platform
   spec:
     realm:
       id: ansible-automation-platform
       realm: ansible-automation-platform
       enabled: true
       displayName: {PlatformNameShort}
     instanceSelector:
       matchLabels:
         app: sso

   필드	description
   metadata.name	구성 리소스(CR)의 이름에 대해 metadata에 고유 값을 설정합니다.
   metadata.namespace	구성 리소스(CR)의 이름에 대해 metadata에 고유 값을 설정합니다.
   metadata.labels.app	라벨을 고유 값으로 설정합니다. 이는 클라이언트 CR을 생성할 때 사용됩니다.
   metadata.labels.realm	라벨을 고유 값으로 설정합니다. 이는 클라이언트 CR을 생성할 때 사용됩니다.
   spec.realm.id	영역 이름 및 ID를 설정합니다. 이 둘은 동일해야 합니다.
   spec.realm.realm	영역 이름 및 ID를 설정합니다. 이 둘은 동일해야 합니다.
   spec.realm.displayname	표시할 이름을 설정합니다.

5. 생성을 클릭하고 프로세스가 완료될 때까지 기다립니다.

절차

1. Operator → 설치된 Operator로 이동합니다.
2. Red Hat Single Sign-On Operator 프로젝트를 선택합니다.
3. Keycloak Client 탭을 선택하고 Create Keycloak Client 를 클릭합니다.
4. Keycloak>-< 양식에서 YAML 보기 를 선택합니다.

5. 기본 YAML 파일을 다음으로 바꿉니다.

   kind: KeycloakClient
   apiVersion: keycloak.org/v1alpha1
   metadata:
     name: automation-hub-client-secret
     labels:
       app: sso
       realm: ansible-automation-platform
     namespace: rh-sso
   spec:
     realmSelector:
       matchLabels:
         app: sso
         realm: ansible-automation-platform
     client:
       name: Automation Hub
       clientId: automation-hub
       secret: <client-secret>                        1
       clientAuthenticatorType: client-secret
       description: Client for {HubNameStart}
       attributes:
         user.info.response.signature.alg: RS256
         request.object.signature.alg: RS256
       directAccessGrantsEnabled: true
       publicClient: true
       protocol: openid-connect
       standardFlowEnabled: true
       protocolMappers:
         - config:
             access.token.claim: "true"
             claim.name: "family_name"
             id.token.claim: "true"
             jsonType.label: String
             user.attribute: lastName
             userinfo.token.claim: "true"
           consentRequired: false
           name: family name
           protocol: openid-connect
           protocolMapper: oidc-usermodel-property-mapper
         - config:
             userinfo.token.claim: "true"
             user.attribute: email
             id.token.claim: "true"
             access.token.claim: "true"
             claim.name: email
             jsonType.label: String
           name: email
           protocol: openid-connect
           protocolMapper: oidc-usermodel-property-mapper
           consentRequired: false
         - config:
             multivalued: "true"
             access.token.claim: "true"
             claim.name: "resource_access.${client_id}.roles"
             jsonType.label: String
           name: client roles
           protocol: openid-connect
           protocolMapper: oidc-usermodel-client-role-mapper
           consentRequired: false
         - config:
             userinfo.token.claim: "true"
             user.attribute: firstName
             id.token.claim: "true"
             access.token.claim: "true"
             claim.name: given_name
             jsonType.label: String
           name: given name
           protocol: openid-connect
           protocolMapper: oidc-usermodel-property-mapper
           consentRequired: false
         - config:
             id.token.claim: "true"
             access.token.claim: "true"
             userinfo.token.claim: "true"
           name: full name
           protocol: openid-connect
           protocolMapper: oidc-full-name-mapper
           consentRequired: false
         - config:
             userinfo.token.claim: "true"
             user.attribute: username
             id.token.claim: "true"
             access.token.claim: "true"
             claim.name: preferred_username
             jsonType.label: String
           name: <username>
           protocol: openid-connect
           protocolMapper: oidc-usermodel-property-mapper
           consentRequired: false
         - config:
             access.token.claim: "true"
             claim.name: "group"
             full.path: "true"
             id.token.claim: "true"
             userinfo.token.claim: "true"
           consentRequired: false
           name: group
           protocol: openid-connect
           protocolMapper: oidc-group-membership-mapper
         - config:
             multivalued: 'true'
             id.token.claim: 'true'
             access.token.claim: 'true'
             userinfo.token.claim: 'true'
             usermodel.clientRoleMapping.clientId:  '{HubName}'
             claim.name: client_roles
             jsonType.label: String
           name: client_roles
           protocolMapper: oidc-usermodel-client-role-mapper
           protocol: openid-connect
         - config:
             id.token.claim: "true"
             access.token.claim: "true"
             included.client.audience: '{HubName}'
           protocol: openid-connect
           name: audience mapper
           protocolMapper: oidc-audience-mapper
     roles:
       - name: "hubadmin"
         description: "An administrator role for {HubNameStart}"

   1

   이 값을 고유한 값으로 바꿉니다.

6. 생성을 클릭하고 프로세스가 완료될 때까지 기다립니다.

절차

1. Operator → 설치된 Operator로 이동합니다.
2. Red Hat Single Sign-On Operator 프로젝트를 선택합니다.
3. Keycloak>-& lt; 탭을 선택하고 Create Keycloak User 를 클릭합니다.
4. Keycloak User 양식에서 YAML 보기 를 선택합니다.

5. 기본 YAML 파일을 다음으로 바꿉니다.

   apiVersion: keycloak.org/v1alpha1
   kind: KeycloakUser
   metadata:
     name: hubadmin-user
     labels:
       app: sso
       realm: ansible-automation-platform
     namespace: rh-sso
   spec:
     realmSelector:
       matchLabels:
         app: sso
         realm: ansible-automation-platform
     user:
       username: hub_admin
       firstName: Hub
       lastName: Admin
       email: hub_admin@example.com
       enabled: true
       emailVerified: false
       credentials:
         - type: password
           value: <ch8ngeme>
       clientRoles:
         automation-hub:
           - hubadmin

6. 생성을 클릭하고 프로세스가 완료될 때까지 기다립니다.

절차

1. Operator Hub 로 이동하여 Ansible Automation Platform Operator를 검색합니다.
2. Ansible Automation Platform Operator 프로젝트를 선택합니다.
3. Operator 타일을 클릭합니다.
4. 설치를 클릭합니다.

5. Operator를 설치할 프로젝트를 선택합니다. Operator 권장 네임스페이스 이름을 사용하는 것이 좋습니다.

   1. 권장 항목이 아닌 프로젝트에 Operator를 설치하려면 드롭다운 메뉴에서 Create Project 를 선택합니다.
   2. 프로젝트 이름을 입력합니다.
   3. 생성을 클릭합니다.
6. 설치를 클릭합니다.
7. Operator가 설치되면 Operator 보기 를 클릭합니다.

절차

1. https://<sso_host>/auth/realms/ansible-automation-platform 로 이동합니다.
2. public_key 값을 복사합니다.
3. OpenShift 웹 UI에서 Workloads → Secrets (시크릿) 로 이동합니다.
4. ansible-automation-platform 프로젝트를 선택합니다.
5. 생성을 클릭하고 YAML에서 을 선택합니다.

6. 다음 YAML을 편집하여 보안을 생성합니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: automation-hub-sso                       1
     namespace: ansible-automation-platform
   type: Opaque
   stringData:
     keycloak_host: "keycloak-rh-sso.apps-crc.testing"
     keycloak_port: "443"
     keycloak_protocol: "https"
     keycloak_realm: "ansible-automation-platform"
     keycloak_admin_role: "hubadmin"
     social_auth_keycloak_key: "automation-hub"
     social_auth_keycloak_secret: "client-secret"   2
     social_auth_keycloak_public_key: >-            3

   1

   이 이름은 자동화 허브 인스턴스를 생성할 때 다음 단계에서 사용됩니다.

   2

   자동화 허브에 대한 Keycloak 클라이언트를 생성할 때 시크릿이 변경된 경우 이 값이 일치하도록 변경해야 합니다.

   3

   Ansible Automation Platform Operator 설치에 복사된 public_key 값을 입력합니다.

7. 생성을 클릭하고 프로세스가 완료될 때까지 기다립니다.

절차

1. Operator → 설치된 Operator로 이동합니다.
2. Ansible Automation Platform을 선택합니다.
3. Automation hub 탭을 선택하고 Create Automation hub 를 클릭합니다.

4. YAML 보기를 선택합니다. YAML은 다음과 유사해야 합니다.

   apiVersion: automationhub.ansible.com/v1beta1
   kind: AutomationHub
   metadata:
     name: private-ah                              1
     namespace: ansible-automation-platform
   spec:
     sso_secret: automation-hub-sso                2
     pulp_settings:
       verify_ssl: false
     route_tls_termination_mechanism: Edge
     ingress_type: Route
     loadbalancer_port: 80
     file_storage_size: 100Gi
     image_pull_policy: IfNotPresent
     web:
       replicas: 1
     file_storage_access_mode: ReadWriteMany
     content:
       log_level: INFO
       replicas: 2
     postgres_storage_requirements:
       limits:
         storage: 50Gi
       requests:
         storage: 8Gi
     api:
       log_level: INFO
       replicas: 1
     postgres_resource_requirements:
       limits:
         cpu: 1000m
         memory: 8Gi
       requests:
         cpu: 500m
         memory: 2Gi
     loadbalancer_protocol: http
     resource_manager:
       replicas: 1
     worker:
       replicas: 2

   1

   인스턴스에 사용할 metadata.name을 이름으로 설정합니다.

   2

   spec.sso_secret을 Red Hat Single Sign On 연결 세부 정보를 유지하기 위해 보안 생성에서 생성된 시크릿 이름으로 설정합니다.

   참고

   이 YAML은 SSL 확인을 비활성화합니다(ssl_verify: false). OpenShift에 자체 서명된 인증서를 사용하지 않는 경우 이 설정을 제거할 수 있습니다.

5. 생성을 클릭하고 프로세스가 완료될 때까지 기다립니다.

절차

1. Networking → Routes (경로) 로 이동합니다.
2. 설치에 사용한 프로젝트를 선택합니다.
3. private-ah-web-svc 서비스의 위치를 복사합니다. 자동화 허브 인스턴스를 만들 때 다른 이름을 사용한 경우 서비스 이름이 다릅니다. 나중에 Red Hat Single Sign-On 클라이언트를 업데이트하는 데 사용됩니다.

절차

1. Operator → 설치된 Operator로 이동합니다.
2. RH-SSO 프로젝트를 선택합니다.
3. Red Hat Single Sign-On Operator 를 클릭합니다.
4. Keycloak Client 를 선택합니다.
5. automation-hub-client-secret 클라이언트를 클릭합니다.
6. YAML 을 선택합니다.

7. 클라이언트 YAML을 업데이트하여 유효한 리디렉션 URI 및 Web Origins 설정을 추가합니다.

   redirectUris:
     - 'https://private-ah-ansible-automation-platform.apps-crc.testing/*'
   webOrigins:
     - 'https://private-ah-ansible-automation-platform.apps-crc.testing'

   필드	description
   redirectURIs	이는 Automation Hub 경로 확인 에서 결정된 위치입니다. redirectUris 설정 끝에 /*를 추가해야 합니다.
   webOrigins	이는 Automation Hub 경로 확인 에서 결정된 위치입니다.

   참고

   이러한 설정을 입력할 때 들여쓰기가 올바른지 확인합니다.

8. 저장을 클릭합니다.

연결 확인

1. 자동화 허브 경로로 이동합니다.
2. hub_admin 사용자 자격 증명을 입력하고 로그인합니다.
3. Red Hat Single Sign-On은 인증을 처리하고 자동화 허브로 다시 리디렉션합니다.