私有雲的邊緣 4.16.09 版
如要在節點上安裝 Edge,您必須先安裝 Edge apigee-setup 公用程式。如果您的節點沒有外部網際網路連線,您也必須安裝 Apigee 存放區的本機副本。
從 /opt/apigee 建立符號連結
Edge 會安裝 /opt/apigee 目錄中的所有檔案。您無法變更這個目錄。不過,如有需要,您可以建立符號連結,將 /opt/apigee 對應至其他位置。
建立符號連結前,您必須先建立名為「apigee」的使用者及群組。也就是由 Edge 安裝程式建立的群組和使用者。
如要建立符號連結,請先執行下列步驟,再下載 bootstrap_4.16.09.sh 檔案。 您必須以根層級執行所有步驟:
- 建立「apigee」使用者和群組:
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c 「Apigee 平台使用者」 apigee - 從 /opt/apigee 建立到所需安裝根的符號連結:
> ln -Ts /srv/myInstallDir /opt/apigee
其中 /srv/myInstallDir 是 Edge 檔案的所需位置。 - 將安裝根和符號連結變更為「apigee」使用者:
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee
必備條件:停用 SELinux
您必須先停用 SELinux 或將其設為寬鬆模式,才能安裝 Edge apigee-setup 公用程式或任何 Edge 元件。如有需要,您可以在安裝 Edge 後重新啟用 SELinux。
- 如要「暫時」將 SELinux 設為寬鬆模式,請執行下列指令:
- 在 Linux 6.x 作業系統上:
echo 0 > /selinux/enforce
如要在安裝 Edge 後重新啟用 SELinux:
echo 1 > /selinux/enforce - 在 Linux 7.x 作業系統上:
setenforce 0
如要在安裝 Edge 後重新啟用 SELinux:
setenforce 1
- 在 Linux 6.x 作業系統上:
- 如要「永久」停用 SELinux 或將其設為寬鬆模式:
- 在編輯器中開啟 /etc/sysconfig/selinux。
- 設定 SELINUX=已停用 或 SELINUX=permissive
- 儲存修改過的內容。
- 重新啟動節點。
- 如有需要,請在 Edge 安裝完成後重複此程序來設定 SELINUX=enabled,藉此重新啟用 SELinux。
在具備外部網際網路連線的節點中安裝 Edge apigee-setup 公用程式
如何在有外部網際網路連線的節點上安裝 Edge:
- 從 Apigee 取得用來存取 Apigee 存放區的使用者名稱和密碼。 如果您已有 Apigee ftp 網站現有的使用者名稱:password,就可以使用這些憑證。
- 以根層級登入節點即可安裝 Edge RPM
注意:雖然 RPM 安裝作業需要 Root 存取權,但您可以在沒有 Root 存取權的情況下執行 Edge 設定。 - 按照上述說明停用 SELinux。
- 將 Edge bootstrap_4.16.09.sh 檔案下載至 /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是 Apigee 提供的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。
根據預設,安裝程式會檢查您是否已安裝 Java 1.8。如果沒有,系統會為您安裝。使用「JAVA_FIX」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 網站現有的使用者名稱:password,就可以使用這些憑證。
- 以根層級登入 RedHat 或 CentOS 節點,即可安裝 Edge RPM。
注意:雖然 RPM 安裝需要 Root 存取權,但您可以在沒有 Root 存取權的情況下執行 Edge 設定。 - 確定您已安裝最新版的 yum-utils:
> sudo yum update yum-utils - 按照上述說明停用 SELinux。
- 將 Edge bootstrap_4.16.09.sh 檔案下載至 /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是 Apigee 提供的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。 - 在節點上安裝 apigee-Mirror 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install
注意:如果你是將現有存放區更新至 4.16.09,則只能更新 apigee-Mirror:
> - 使用 apigee-Mirror 公用程式,將 Apigee 存放區同步處理至 /opt/apigee/data/apigee-Mirror/repos/ 目錄。
如要盡量減少存放區的大小,請加入 --only-new-rpms 只下載最新的 RPM 檔案。您需要大約 1.6 GB 的磁碟空間才能下載:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror sync --only-new-rpms
如要下載整個存放區 (包括較舊的 RPM),請省略 --only-new-rpms。您需要約 6 GB 的磁碟空間才能完整下載:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror sync
您現在可以儲存 Apigee 存放區的本機副本。下一節將說明如何從本機存放區安裝 Edge apigee-setup 公用程式。 -
(選用) 如要將本機存放區中的 Edge 安裝到託管本機存放區的同一節點中,請先執行下列指令:
- 從本機存放區執行 bootstrap_4.16.09.sh 來安裝 apigee-service 公用程式:
> sudo bash /opt/apigee/data/apigee-Mirror/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigee 傳送到 repobasepath=/opt/apigee/data/apigee-repo/ - 使用 apigee-service 安裝 apigee-setup 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - 使用 apigee-setup,在節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
- 從本機存放區執行 bootstrap_4.16.09.sh 來安裝 apigee-service 公用程式:
在本機存放區的遠端節點中安裝 apigee-setup
您可以透過兩種方式從本機存放區安裝 Edge。你可以採取下列其中一種做法:
- 建立存放區的 .tar 檔案,將 .tar 檔案複製到節點,然後從 .tar 檔案安裝 Edge。
- 在含有本機存放區的節點中安裝網路伺服器,方便其他節點存取。 Apigee 提供 Nginx 網路伺服器供您使用,或者您也可以使用自己的網路伺服器。
從 .tar 檔案安裝:
- 在本機存放區的節點上,使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz 的單一.tar 檔案:
/opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz - 將 .tar 檔案複製到您要安裝 Edge 的節點。例如,將其複製到新節點上的 /tmp 目錄。
- 按照上述說明,在新節點上停用 SELinux。
- 在新節點上,解壓縮檔案至 /tmp 目錄:
> tar -xzf apigee-4.16.09.tar.gz
這個指令會在包含 .tar 檔案的目錄中建立名為「存放區」的新目錄,例如 /tmp/repos。 - 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/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。如何變更這些值
- 在編輯器中開啟 /opt/apigee/customer/application/mirror.properties。若檔案不存在,請建立檔案。
- 視需要設定下列值:
conf_apigee_Mirror_listen_port=3939
conf_apigee_Mirror_server_name=localhost - 重新啟動 Nginx:
> /opt/nginx/scripts/apigee-nginx restart
- 根據預設,存放區會需要 admin:admin 的使用者名稱:密碼。如要變更這些憑證,請設定下列環境變數:
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord - 按照上述說明,在新節點上停用 SELinux。
- 在遠端節點上,將 <使用者名稱> 設為 <使用者名稱> 的 Bootstrap_4.16.09.sh 檔案,然後下載至 /tmp/bootstrap_4.16.09.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo.4.4.16.。 - 在遠端節點中,安裝 Edge apigee-service 公用程式和依附元件:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeeuser=uName apigeepassword=pWordName。 - 在遠端節點上,使用 apigee-service 安裝 apigee-setup 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - 使用 apigee-setup,在遠端節點上安裝及設定 Edge 元件。詳情請參閱「在節點上安裝 Edge 元件」。
更新本機 Apigee 存放區
如要更新存放區,您必須下載最新的 bootstrap_4.16.09.sh 檔案,然後執行新的同步處理:
- 將 Edge bootstrap_4.16.09.sh 檔案下載至 /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - 執行 Edge bootstrap_4.16.09.sh 檔案:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是 Apigee 提供的使用者名稱和密碼。如果省略 pWord,系統會提示您輸入。 - 更新 apigee-Mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 更新 - 執行同步處理作業:
> /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.09 存放區中新增或更新 Edge 4.16.01/4.16.05
如果必須維護 4.16.09 存放區中 Edge 4.16.01 和 4.16.05 的安裝內容,您可以維護包含所有版本的存放區。接著,您就可以從該存放區安裝任何版本的 Edge。
如要新增 4.16.01/4.16.05 至 4.16.09 存放區,請按照下列指示操作:
- 請確認您已安裝 4.16.09 版的 apigee-Mirror 公用程式:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 版本
你應該會看到以下形式的結果,其中 xyz 是版本號碼:
apigee-Mirror-xyzxyz - 使用 apigee-Mirror 公用程式下載 Edge 4.16.01 或 4.16.05 至存放區。請留意指令加上指令前綴使用的 apigeereleasever=4.16.01 或 apigeereleasever=4.16.05:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-repo sync --only-new-rpm1
更新。 - 檢查 /opt/apigee/data/apigee-mirror/repos 目錄,並查看檔案結構:
> ls /opt/apigee/data/apigee-Mirror/repos
應該會看到下列檔案和目錄:
/opt/apigee/data/apigee-mirror/repos
apigee 目錄也包含了每個 Edge 版本的個別目錄。 - 如要將存放區封裝為 .tar 檔案,請使用下列指令:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件
這個指令會將 4.16.09 和 4.16.01 存放區封裝到同一個 tar 檔案中。您無法只封裝存放區的一部分。
如要從本機存放區或 .tar 檔案安裝 Edge,請務必使用下列指令執行正確的 Bootstrap 檔案:
- 如果是從 .tar 檔案安裝,請從存放區中執行正確的 Bootstrap 檔案:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
如要完成安裝程序,請按照上述「安裝 - 如果使用 Nginx 網路伺服器進行安裝,請從存放區下載正確的 Bootstrap 檔案。
bootstrap_4.16.0X.sh