Rejestrowanie organizacji

Edge dla chmury prywatnej w wersji 4.16.05

Aby przeprowadzić proces wprowadzenia, użyj polecenia setup-org. Polecenie musisz uruchomić na węźle serwera zarządzania.

W ramach procesu wprowadzenia skrypt:

Opcjonalnie tworzy nowego użytkownika, który będzie pełnił funkcję administratora organizacji.

  • Tworzy organizację.
  • Dodaje określonego użytkownika jako administratora organizacji. Użytkownik musi już istnieć, w przeciwnym razie skrypt zgłosi błąd.
  • Powiąż organizację z pod, domyślnie jest ona powiązana z pod „gateway”.
  • Utwórz środowisko.
  • Utwórz hosta wirtualnego dla środowiska.
  • Powiąż środowisko ze wszystkimi procesorami komunikatów.
  • Włącza statystyki.

Plik konfiguracji dyskretnej na potrzeby wprowadzenia

Przekaż plik konfiguracji do polecenia setup-org. Wywołaj polecenie setup-org i określ opcję -f, podając ścieżkę do pliku konfiguracji trybu cichego:

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f /tmp/configFile

Jedynym wymaganiem dotyczącym instalacji cichych jest to, że plik konfiguracji musi być dostępny lub możliwy do odczytania przez użytkownika „apigee”. Możesz na przykład umieścić plik w katalogu /tmp w węźle.

Poniżej znajdziesz przykładowy plik konfiguracji instalacji dyskretnej. Zmodyfikuj go zgodnie ze swoimi wymaganiami:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as organization administrator.
#
# Create a new user for the organization administrator. 
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com

# Specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com
# Specify environment name. 
ENV_NAME=prod

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host, 
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" 

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore. 
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one. 

# Specify the analytics group. 
# AXGROUP=axgroup-001 # Default name is axgroup-001.

Uwagi:

  • Jeśli masz już rekord DNS, którego będziesz używać do uzyskiwania dostępu do hosta wirtualnego, w polu VHOST_ALIAS podaj alias hosta i opcjonalnie port, na przykład „myapi.example.com”.

    Jeśli nie masz jeszcze rekordu DNS, więcej informacji znajdziesz w artykule o konfigurowaniu hosta wirtualnego.
  • Więcej informacji o tworzeniu pliku JAR i innych aspektach konfigurowania TLS/SSL znajdziesz w artykułach Magazyny kluczy i magazyny zaufanych certyfikatów oraz Konfigurowanie TLS/SSL w Edge On Premises.

Wprowadzenie

  1. Zainstaluj apigee-provision w węźle serwera zarządzania:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Uruchom polecenie w węźle serwera zarządzania:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Plik konfiguracji musi być dostępny lub możliwy do odczytania przez użytkownika „apigee”. Możesz na przykład umieścić plik w katalogu /tmp w węźle.

Weryfikacja podczas rejestracji

Po zakończeniu procesu wprowadzenia sprawdź stan systemu, uruchamiając te polecenia CURL na węźle serwera zarządzania.

  1. Sprawdź stan użytkownika i organizacji na serwerze zarządzania, wykonując te polecenia CURL:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments
  2. Jeśli masz włączone statystyki, użyj tego polecenia:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. Stan bazy danych PostgreSQL możesz też sprawdzić, uruchamiając na maszynie 2 to polecenie, aby uruchomić psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    W wierszu poleceń wpisz to polecenie, aby wyświetlić tabelę statystyk swojej organizacji:
    apigee=# : \d analytics."<orgname>.prod.fact"

    Aby zamknąć psql, użyj tego polecenia:
    apigee=# \q
  4. Uzyskaj dostęp do interfejsu Apigee Edge za pomocą przeglądarki. Pamiętaj, że adres URL konsoli zarządzania został już zapisany na końcu instalacji.
    1. Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda on podobnie do tego, gdzie adres IP dotyczy Maszyny 1 lub maszyny, na której zainstalowano interfejs użytkownika w przypadku konfiguracji alternatywnych:
      http://192.168.56.111:9000/login

      9000 to numer portu używany przez interfejs użytkownika. Jeśli uruchamiasz przeglądarkę bezpośrednio na serwerze hostującym interfejs Edge, możesz użyć adresu URL w formacie:
      http://localhost:9000/login

      Uwaga: upewnij się, że port 9000 jest otwarty.
    2. Na stronie logowania do konsoli podaj nazwę użytkownika i hasło administratora systemu Apigee.
      Uwaga: jest to globalne hasło administratora systemu ustawione podczas instalacji. Możesz też:
  5. Zarejestruj nowe konto użytkownika Apigee i zaloguj się przy użyciu nowych danych logowania.
    1. Kliknij Zaloguj się. Przeglądarka przekieruje Cię na stronę:
      http://192.168.56.111:9000/platform/#/<nazwa_organizacji>/

      i otworzy panel, który umożliwia skonfigurowanie utworzonej wcześniej organizacji (jeśli zalogujesz się przy użyciu danych logowania administratora Apigee).
    2. Jeśli dopiero zaczynasz korzystać z Edge, możesz teraz utworzyć swój pierwszy serwer proxy interfejsu API. Więcej informacji znajdziesz w artykule Tworzenie pierwszego serwera proxy interfejsu API.