Instalowanie narzędzia Edge apigee

Edge dla chmury prywatnej w wersji 4.16.09

Aby zainstalować Edge w węźle, najpierw zainstaluj narzędzie Edge apigee-setup. Jeśli pracujesz w środowisku, w którym węzły nie mają zewnętrznego połączenia z internetem, musisz też zainstalować lokalną kopię repozytorium Apigee.

Tworzenie dowiązania symbolicznego z /opt/apigee

Edge instaluje wszystkie pliki w katalogu /opt/apigee. Nie możesz zmienić tego katalogu. Jeśli chcesz, możesz jednak utworzyć dowiązanie symboliczne, aby zmapować /opt/apigee na inną lokalizację.

Zanim utworzysz dowiązanie symboliczne, musisz najpierw utworzyć użytkownika i grupę o nazwie „apigee”. Jest to ta sama grupa i ten sam użytkownik, które zostały utworzone przez instalator Edge.

Aby utworzyć dowiązanie symboliczne, wykonaj te czynności przed pobraniem pliku bootstrap_4.16.09.sh. Wszystkie te czynności musisz wykonać jako użytkownik root:

  1. Utwórz użytkownika i grupę „apigee”:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. Utwórz dowiązanie symboliczne z /opt/apigee do wybranego katalogu głównego instalacji:
    > ln -Ts /srv/myInstallDir /opt/apigee
    gdzie /srv/myInstallDir to wybrana lokalizacja plików Edge.
  3. Zmień właściciela katalogu głównego instalacji i dowiązania symbolicznego na użytkownika „apigee”:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Wymaganie wstępne: wyłączenie SELinux

Zanim zainstalujesz narzędzie Edge apigee-setup lub dowolne komponenty Edge, musisz wyłączyć SELinux lub ustawić go w trybie permissive. W razie potrzeby po zainstalowaniu Edge możesz ponownie włączyć SELinux.

  • Aby tymczasowo ustawić SELinux w trybie permissive, wykonaj to polecenie:
    1. W systemie operacyjnym Linux 6.x:
      echo 0 > /selinux/enforce

      Aby ponownie włączyć SELinux po zainstalowaniu Edge:
      echo 1 > /selinux/enforce
    2. W systemie operacyjnym Linux 7.x:
      setenforce 0

      Aby ponownie włączyć SELinux po zainstalowaniu Edge:
      setenforce 1
  • Aby na stałe wyłączyć SELinux lub ustawić go w trybie permisywnym:
    1. Otwórz plik /etc/sysconfig/selinux w edytorze.
    2. Ustaw SELINUX=disabled lub SELINUX=permissive.
    3. Zapisz zmiany.
    4. Uruchom ponownie węzeł.
    5. W razie potrzeby po instalacji Edge ponownie włącz SELinux, powtarzając tę procedurę, aby ustawić SELINUX=enabled.

Zainstaluj narzędzie apigee-setup Edge na węźle z zewnętrznym połączeniem internetowym.

Aby zainstalować Edge na węźle z zewnętrznym połączeniem internetowym:

  1. Uzyskaj od Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika i hasło do witryny FTP Apigee, możesz użyć tych danych logowania.
  2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
    Uwaga: instalacja pakietów RPM wymaga dostępu na poziomie root, ale konfigurację Edge można przeprowadzić bez takiego dostępu.
  3. Wyłącz SELinux w sposób opisany powyżej.
  4. Pobierz plik Edge bootstrap_4.16.09.sh do /tmp/bootstrap_4.16.09.sh:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  5. Zainstaluj narzędzie Edge apigee-service i zależności:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.

    Domyślnie instalator sprawdza, czy masz zainstalowaną Javę 1.8. Jeśli nie, zainstaluje ją za Ciebie. Aby określić, jak ma być obsługiwana instalacja Javy, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

    I = zainstaluj OpenJDK 1.8 (domyślnie)
    C = kontynuuj bez instalowania Javy
    Q = zamknij. W przypadku tej opcji musisz samodzielnie zainstalować Javę.

    Instalacja narzędzia apigee-service powoduje utworzenie pliku /etc/yum.repos.d/apigee.repo, który definiuje repozytorium Apigee. Aby wyświetlić plik definicji, użyj polecenia:
    > cat /etc/yum.repos.d/apigee.repo

    Aby wyświetlić zawartość repozytorium, użyj polecenia:
    > sudo yum -v repolist 'apigee*'
  6. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Instalowanie narzędzia apigee-setup Edge na węźle bez zewnętrznego połączenia z internetem

Jeśli węzły Edge znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do repozytorium Apigee przez internet, musisz utworzyć lokalne repozytorium lub kopię lustrzaną repozytorium Apigee. To lustro musi być dostępne dla wszystkich węzłów. Po utworzeniu węzły mogą uzyskać dostęp do tego lokalnego serwera lustrzanego, aby zainstalować Edge.

Uwaga: Apigee nie hostuje wszystkich zależności innych firm w naszych publicznych repozytoriach. Musisz pobrać i zainstalować te zależności z publicznie dostępnych repozytoriów.

Po utworzeniu lokalnego repozytorium Edge może być konieczne zaktualizowanie go za pomocą najnowszych plików wersji Edge. W poniższych sekcjach opisano, jak utworzyć lokalne repozytorium i jak je zaktualizować.

Tworzenie lokalnego repozytorium Apigee

Aby utworzyć lokalne repozytorium Apigee:

  1. Uzyskaj od Apigee nazwę użytkownika i hasło, których używasz do uzyskiwania dostępu do repozytorium Apigee. Jeśli masz już nazwę użytkownika i hasło do witryny FTP Apigee, możesz użyć tych danych logowania.
  2. Zaloguj się w węźle RedHat lub CentOS jako użytkownik root, aby zainstalować pakiety RPM Edge.
    Uwaga: instalacja RPM wymaga dostępu do konta root, ale konfigurację Edge można przeprowadzić bez niego.
  3. Sprawdź, czy masz najnowszą wersję yum-utils:
    > sudo yum update yum-utils
  4. Wyłącz SELinux w sposób opisany powyżej.
  5. Pobierz plik Edge bootstrap_4.16.09.sh do /tmp/bootstrap_4.16.09.sh:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. Zainstaluj narzędzie Edge apigee-service i zależności:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.
  7. Zainstaluj narzędzie apigee-mirror w węźle:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Uwaga: jeśli aktualizujesz istniejące repozytorium do wersji 4.16.09, musisz tylko zaktualizować apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  8. Użyj narzędzia apigee-mirror, aby zsynchronizować repozytorium Apigee z katalogiem /opt/apigee/data/apigee-mirror/repos/.

    Aby zminimalizować rozmiar repozytorium, dodaj flagę --only-new-rpms, aby pobrać tylko najnowsze pakiety RPM. Do pobrania potrzebujesz około 1,6 GB miejsca na dysku:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Jeśli chcesz pobrać całe repozytorium, w tym starsze pakiety RPM, pomiń --only-new-rpms. Do pobrania wszystkich plików potrzebujesz około 6 GB miejsca na dysku:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Masz teraz lokalną kopię repozytorium Apigee. W następnej sekcji opisano, jak zainstalować narzędzie Edge apigee-setup z lokalnego repozytorium.
  9. (Opcjonalnie) Jeśli chcesz zainstalować Edge z lokalnego repozytorium w tym samym węźle, który hostuje lokalne repozytorium, musisz najpierw uruchomić te polecenia:
    1. Uruchom skrypt bootstrap_4.16.09.sh z lokalnego repozytorium, aby zainstalować narzędzie apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Instalowanie apigee-setup na węźle zdalnym z repozytorium lokalnego

Możesz zainstalować Edge z lokalnego repozytorium na 2 sposoby. Możesz:

  • Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zainstaluj Edge z pliku .tar.
  • Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW Nginx, ale możesz też użyć własnego serwera WWW.

Zainstaluj z pliku .tar:

  1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Skopiuj plik .tar do węzła, w którym chcesz zainstalować Edge. Możesz go na przykład skopiować do katalogu /tmp w nowym węźle.
  3. Na nowym węźle wyłącz SELinux zgodnie z opisem powyżej.
  4. Na nowym węźle rozpakuj plik do katalogu /tmp:
    > tar -xzf apigee-4.16.09.tar.gz

    To polecenie tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. na przykład /tmp/repos.
  5. Zainstaluj narzędzie Edge apigee-service i zależności z /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Zwróć uwagę, że w tym poleceniu podajesz ścieżkę do katalogu repos.
  6. Użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Zainstaluj z repozytorium za pomocą serwera WWW Nginx:

  1. Zainstaluj serwer WWW Nginx w węźle repozytorium:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Domyślnie Nginx jest skonfigurowany do używania localhost jako nazwy serwera i portu 3939. Aby zmienić te wartości:
    1. Otwórz plik /opt/apigee/customer/application/mirror.properties w edytorze. Jeśli plik nie istnieje, utwórz go.
    2. W razie potrzeby ustaw te wartości:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Uruchom ponownie Nginx:
      > /opt/nginx/scripts/apigee-nginx restart
  3. Domyślnie repozytorium wymaga nazwy użytkownika i hasła admin:admin. Aby zmienić te dane logowania, ustaw te zmienne środowiskowe:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. Na nowym węźle wyłącz SELinux zgodnie z opisem powyżej.
  5. On the remote node, download the Edge bootstrap_4.16.09.sh file to /tmp/bootstrap_4.16.09.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh

    where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node.
  6. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.
  7. W węźle zdalnym użyj apigee-service, aby zainstalować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Użyj apigee-setup, aby zainstalować i skonfigurować komponenty Edge w węźle zdalnym. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge w węźle.

Aktualizowanie lokalnego repozytorium Apigee

Aby zaktualizować repozytorium, musisz pobrać najnowszy plik bootstrap_4.16.09.sh, a następnie przeprowadzić nową synchronizację:

  1. Pobierz plik Edge bootstrap_4.16.09.sh do /tmp/bootstrap_4.16.09.sh:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  2. Uruchom plik Edge bootstrap_4.16.09.sh:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.
  3. Zaktualizuj apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Przeprowadź synchronizację:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Jeśli chcesz pobrać całe repozytorium:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Czyszczenie lokalnego repozytorium Apigee

Czyszczenie lokalnego repozytorium powoduje usunięcie katalogów /opt/apigee/data/apigee-mirror i /var/tmp/yum-apigee-*.

Aby wyczyścić lokalne repozytorium, użyj polecenia:

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

Dodawanie lub aktualizowanie Edge 4.16.01/4.16.05 w repozytorium 4.16.09

Jeśli musisz utrzymywać instalacje Edge 4.16.01 i 4.16.05 w repozytorium 4.16.09, możesz utrzymywać repozytorium zawierające wszystkie wersje. Z tego repozytorium możesz zainstalować dowolną wersję Edge.

Aby dodać wersję 4.16.01/4.16.05 do repozytorium 4.16.09:

  1. Sprawdź, czy masz zainstalowaną wersję 4.16.09 narzędzia apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Powinien wyświetlić się wynik w poniższym formacie, gdzie xyz to numer kompilacji:
    apigee-mirror-4.16.09-0.0.xyz
  2. Użyj narzędzia apigee-mirror, aby pobrać Edge 4.16.01 lub 4.16.05 do repozytorium. Zwróć uwagę, że polecenie jest poprzedzone prefiksem apigeereleasever=4.16.01 lub apigeereleasever=4.16.05:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Użyj tego samego polecenia, aby później zaktualizować repozytorium 4.16.01/4.16.05.
  3. Sprawdź strukturę plików w katalogu /opt/apigee/data/apigee-mirror/repos:
    > ls /opt/apigee/data/apigee-mirror/repos

    Powinny być widoczne te pliki i katalogi:
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.16.09.sh thirdparty

    Zwróć uwagę, że masz plik bootstrap dla wszystkich wersji Edge. Katalog apigee zawiera też osobne katalogi dla każdej wersji Edge.
  4. Aby spakować repozytorium do pliku .tar, użyj tego polecenia:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    To polecenie pakuje repozytoria 4.16.09 i 4.16.01 do tego samego pliku .tar. Nie możesz spakować tylko części repozytorium.

Aby zainstalować Edge z lokalnego repozytorium lub pliku .tar, uruchom odpowiedni plik bootstrap za pomocą jednego z tych poleceń:

  • Jeśli instalujesz z pliku .tar, uruchom odpowiedni plik bootstrap z repozytorium:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Aby dokończyć instalację, wykonaj pozostałe czynności opisane w sekcji „Instalowanie z pliku .tar” powyżej.
  • Jeśli instalujesz za pomocą serwera WWW Nginx, pobierz i uruchom odpowiedni plik wczytywania z repozytorium:
    > /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://

    Aby dokończyć instalację, wykonaj pozostałe czynności opisane w sekcji „Instalowanie z repozytorium za pomocą serwera WWW Nginx” powyżej.