Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Edge apigee-setup 유틸리티 설치

프라이빗 클라우드용 Edge v. 4.16.05

노드에 Edge를 설치하려면 먼저 Edge apigee-setup 유틸리티를 설치합니다. 노드에 외부 인터넷 연결이 없는 환경에 있는 경우 Apigee 저장소의 로컬 사본도 설치해야 합니다.

/opt/apigee에서 심볼릭 링크 만들기

Edge는 /opt/apigee 디렉터리에 모든 파일을 설치합니다. 이 디렉터리는 변경할 수 없습니다. 하지만 원하는 경우 심볼릭 링크를 만들어 /opt/apigee를 다른 위치에 매핑할 수 있습니다.

심볼릭 링크를 만들기 전에 먼저 'apigee'라는 사용자와 그룹을 만들어야 합니다. 이는 Edge 설치 프로그램에서 만든 것과 동일한 그룹 및 사용자입니다.

심볼릭 링크를 만들려면 bootstrap_4.16.05.sh 파일을 다운로드하기 전에 다음 단계를 수행합니다. 루트로 다음 단계를 모두 수행해야 합니다.

'apigee' 사용자 및 그룹을 만듭니다.
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
/opt/apigee에서 원하는 설치 루트로 심볼릭 링크를 만듭니다.
> ln -Ts /srv/myInstallDir /opt/apigee
여기서 /srv/myInstallDir은 Edge 파일의 원하는 위치입니다.
설치 루트 및 심볼릭 링크의 소유권을 'apigee' 사용자로 변경합니다.
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee

선행 조건: SELinux 사용 중지

Edge apigee-setup 유틸리티 또는 Edge 구성요소를 설치하려면 먼저 SELinux를 사용 중지하거나 허용 모드로 설정해야 합니다. 필요한 경우 Edge를 설치한 후 SELinux를 다시 사용 설정할 수 있습니다.

SELinux를 허용 모드로 일시적으로 설정하려면 다음 명령어를 실행합니다.
1. Linux 6.x 운영체제:
  echo 0 > /selinux/enforce
  
  Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 명령어를 실행합니다.
  echo 1 > /selinux/enforce
2. Linux 7.x 운영체제:
  setenforce 0
  
  Edge를 설치한 후 SELinux를 다시 사용 설정하려면 다음 안내를 따르세요.
  setenforce 1
SELinux를 영구적으로 사용 중지하거나 허용 모드로 설정하려면 다음 안내를 따르세요.
1. 편집기에서 /etc/sysconfig/selinux를 엽니다.
2. SELINUX=disabled 또는 SELINUX=permissive를 설정합니다.
3. 수정사항을 저장합니다.
4. 노드를 다시 시작합니다.
5. 필요한 경우 이 절차를 반복하여 SELINUX=enabled를 설정하여 Edge 설치 후 SELinux를 다시 사용 설정합니다.

외부 인터넷 연결이 있는 노드에 Edge apigee-setup 유틸리티 설치

외부 인터넷 연결이 있는 노드에 Edge를 설치하려면 다음 안내를 따르세요.

Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee ftp 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
루트로 노드에 로그인하여 Edge RPM을 설치합니다.
참고: RPM 설치에는 루트 액세스 권한이 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수 있습니다.
위에서 설명한 대로 SELinux를 사용 중지합니다.
Edge bootstrap_4.16.05.sh 파일을 /tmp/bootstrap_4.16.05.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

기본적으로 설치 프로그램은 Java 1.8이 설치되어 있는지 확인합니다. 설치되어 있지 않으면 자동으로 설치됩니다. JAVA_FIX 옵션을 사용하여 Java 설치를 처리하는 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.

I = OpenJDK 1.8 설치 (기본값)
C = Java를 설치하지 않고 계속
Q = 종료 이 옵션을 사용하려면 Java를 직접 설치해야 합니다.

apigee-service 유틸리티를 설치하면 Apigee 저장소를 정의하는 /etc/yum.repos.d/apigee.repo 파일이 생성됩니다. 정의 파일을 보려면 다음 명령어를 사용합니다.
> cat /etc/yum.repos.d/apigee.repo

저장소 콘텐츠를 보려면 다음 명령어를 사용합니다.
> sudo yum -v repolist 'apigee*'
apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

외부 인터넷 연결이 없는 노드에 Edge apigee-setup 유틸리티 설치

Edge 노드가 방화벽 뒤에 있거나 다른 방식으로 인터넷을 통해 Apigee 저장소에 액세스할 수 없는 경우 Apigee 저장소의 로컬 저장소 또는 미러를 만들어야 합니다. 그런 다음 모든 노드에서 해당 미러에 액세스할 수 있어야 합니다. 생성된 노드는 해당 로컬 미러에 액세스하여 Edge를 설치할 수 있습니다.

참고: Apigee는 공개 저장소에 모든 서드 파티 종속 항목을 호스팅하지 않습니다. 공개적으로 액세스할 수 있는 저장소에서 이러한 종속 항목을 다운로드하고 설치해야 합니다.

로컬 Edge 저장소를 만든 후 나중에 최신 Edge 출시 파일로 업데이트해야 할 수 있습니다. 다음 섹션에서는 로컬 저장소를 만들고 업데이트하는 방법을 설명합니다.

로컬 Apigee 저장소 만들기

로컬 Apigee 저장소를 만들려면 다음 안내를 따르세요.

Apigee 저장소에 액세스하는 데 사용하는 Apigee의 사용자 이름과 비밀번호를 가져옵니다. Apigee ftp 사이트에 기존 사용자 이름:비밀번호가 있는 경우 해당 사용자 인증 정보를 사용할 수 있습니다.
Edge RPM을 설치하려면 RedHat 또는 CentOS 노드에 루트로 로그인합니다.
참고: RPM 설치에는 루트 액세스 권한이 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수 있습니다.
yum-utils의 최신 버전이 있는지 확인합니다. > sudo yum update yum-utils
위에서 설명한 대로 SELinux를 사용 중지합니다.
Edge bootstrap_4.16.05.sh 파일을 /tmp/bootstrap_4.16.05.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
노드에 apigee-mirror 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
apigee-mirror 유틸리티를 사용하여 Apigee 저장소를 /opt/apigee/data/apigee-mirror/repos/ 디렉터리에 동기화합니다.

저장소 크기를 최소화하려면 --only-new-rpms를 포함하여 최신 RPM만 다운로드합니다. 다운로드하려면 약 1.6GB의 디스크 공간이 필요합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

이전 RPM을 포함하여 전체 저장소를 다운로드하려면 --only-new-rpms를 생략합니다. 전체 다운로드에는 약 6GB의 디스크 공간이 필요합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

이제 Apigee 저장소의 로컬 사본이 있습니다. 다음 섹션에서는 로컬 저장소에서 Edge apigee-setup 유틸리티를 설치하는 방법을 설명합니다.
(선택사항) 로컬 저장소에서 로컬 저장소를 호스팅하는 동일한 노드에 Edge를 설치하려면 먼저 다음 명령어를 실행해야 합니다.
1. 로컬 저장소에서 bootstrap_4.16.05.sh를 실행하여 apigee-service 유틸리티를 설치합니다.
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
2. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
3. apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

로컬 저장소에서 원격 노드에 apigee-setup 설치

로컬 저장소에서 Edge를 설치하는 방법에는 두 가지가 있습니다. 대신 다음 중 원하는 방법을 선택합니다.

저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 후 .tar 파일에서 Edge를 설치합니다.
다른 노드가 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹 서버를 설치합니다. Apigee는 사용할 수 있는 Nginx 웹 서버를 제공하거나 자체 웹 서버를 사용할 수 있습니다.

.tar 파일에서 설치:

로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz라는 단일 .tar 파일로 패키징합니다.

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Edge를 설치하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
새 노드에서 파일을 /tmp 디렉터리에 untar합니다.
> tar -xzf apigee-4.16.05.tar.gz

이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos입니다.
/tmp/repos에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

이 명령어에 repos 디렉터리의 경로를 포함해야 합니다.
apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup을 사용하여 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

Nginx 웹 서버를 사용하여 저장소에서 설치합니다.

저장소 노드에 Nginx 웹 서버를 설치합니다.
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
기본적으로 Nginx는 localhost를 서버 이름으로 사용하고 포트 3939를 사용하도록 구성됩니다. 이 값을 변경하려면 다음 단계를 따르세요.
1. 편집기에서 /opt/apigee/customer/application/mirror.properties를 엽니다. 파일이 없으면 만듭니다.
2. 필요에 따라 다음 값을 설정합니다.
  conf_apigee_mirror_listen_port=3939
  conf_apigee_mirror_server_name=localhost
3. Nginx를 다시 시작합니다.
  > /opt/nginx/scripts/apigee-nginx restart
기본적으로 저장소에는 admin:admin의 사용자 이름:비밀번호가 필요합니다. 이 사용자 인증 정보를 변경하려면 다음 환경 변수를 설정합니다.
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
새 노드에서 위에 설명된 대로 SELinux를 사용 중지합니다.
원격 노드에서 Edge bootstrap_4.16.05.sh 파일을 /tmp/bootstrap_4.16.05.sh에 다운로드합니다.
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.
원격 노드에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.
원격 노드에서 apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup을 사용하여 원격 노드에 Edge 구성요소를 설치하고 구성합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참조하세요.

로컬 Apigee 저장소 업데이트

저장소를 업데이트하려면 최신 bootstrap_4.16.05.sh 파일을 다운로드한 후 새 동기화를 수행해야 합니다.

Edge bootstrap_4.16.05.sh 파일을 /tmp/bootstrap_4.16.05.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
동기화를 수행합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
전체 저장소를 다운로드하려면 다음 안내를 따르세요.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

로컬 Apigee 저장소 정리

로컬 저장소를 정리하면 /opt/apigee/data/apigee-mirror 및 /var/tmp/yum-apigee-*가 삭제됩니다.

로컬 저장소를 정리하려면 다음을 사용합니다.

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

4.16.05 저장소에 Edge 4.16.01 추가 또는 업데이트

Edge 4.16.05 및 4.16.01 모두에 대한 설치를 유지해야 하는 경우 두 버전이 모두 포함된 저장소를 유지할 수 있습니다. 그런 다음 해당 저장소에서 Edge 4.16.05 및 4.16.01을 설치할 수 있습니다.

4.15.05 저장소에 4.16.01을 추가하려면 다음 안내를 따르세요.

4.16.05 버전의 apigee-mirror 유틸리티를 설치했는지 확인합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

아래 형식의 결과가 표시됩니다. 여기서 xyz는 빌드 번호입니다.
apigee-mirror-4.16.05-0.0.xyz
apigee-mirror 유틸리티를 사용하여 Edge 4.16.01을 저장소에 다운로드합니다. 명령어 앞에 apigeereleasever=4.16.01을 추가하는 방법을 확인하세요.
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

나중에 이 명령어를 사용하여 4.16.01 저장소를 업데이트합니다.
/opt/apigee/data/apigee-mirror/repos 디렉터리를 검사하여 파일 구조를 확인합니다.
> ls /opt/apigee/data/apigee-mirror/repos

다음 파일과 디렉터리가 표시됩니다.
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh thirdparty

두 버전의 Edge에 대한 부트스트랩 파일이 있습니다. apigee 디렉터리에는 각 Edge 버전에 대한 별도의 디렉터리도 포함되어 있습니다.
저장소를 .tar 파일로 패키징하려면 다음 명령어를 사용합니다.
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

이 명령어는 4.16.05 및 4.16.01 저장소를 모두 동일한 .tar 파일로 패키징합니다. 저장소의 일부만 패키징할 수는 없습니다.

로컬 저장소 또는 .tar 파일에서 Edge를 설치하려면 다음 명령어 중 하나를 사용하여 올바른 부트스트랩 파일을 실행해야 합니다.

.tar 파일에서 설치하는 경우 저장소에서 올바른 부트스트랩 파일을 실행합니다.
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

설치를 완료하려면 위의 '.tar 파일에서 설치'의 나머지 단계를 따르세요.
Nginx 웹 서버를 사용하여 설치하는 경우 저장소에서 올바른 부트스트랩 파일을 다운로드한 후 실행합니다.
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
> sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

설치를 완료하려면 위의 'Nginx 웹 서버를 사용하여 저장소에서 설치'의 나머지 단계를 따르세요.