Rejestrowanie organizacji

Aby zarejestrować organizację, musisz utworzyć plik konfiguracji wprowadzenia i przekazać go do polecenia setup-org. Opis każdego z tych kroków znajdziesz w kolejnych sekcjach.

Informacje o tym, jak zarejestrować organizację za pomocą interfejsu Management API, znajdziesz w artykule o tworzeniu organizacji, środowiska i hosta wirtualnego.

Tworzenie pliku konfiguracji wprowadzenia

Ta sekcja zawiera przykładowy plik konfiguracji umożliwiający wprowadzenie organizacji za pomocą setup-org.

Skopiuj poniższy przykład i w razie potrzeby wprowadź zmiany w swojej organizacji:

IP1=192.168.1.1

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

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

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

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the 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
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, 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  # lowercase only

# 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.

Pamiętaj, że:

Uruchom konfigurację-org

Po utworzeniu pliku konfiguracji wprowadzenia przekazujesz go do skryptu setup-org, aby go przeprowadzić. Musisz uruchomić skrypt w węźle serwera zarządzania.

Podczas wprowadzania organizacji skrypt setup-org wykonuje te czynności:

  • Tworzy nową organizację.
  • Tworzy środowisko.
  • Tworzy hosta wirtualnego dla środowiska.
  • Ustawia określonego użytkownika jako administratora organizacji. Uwaga:
    • Możesz użyć istniejącego konta użytkownika lub utworzyć nowe konto dla administratora organizacji.
    • Administrator organizacji nie może być tym samym administratorem organizacji.
  • Wiąże organizację z podem „gateway”. Jest to ustawienie domyślne i nie można go zmienić.
  • Przypisuje środowisko ze wszystkimi podmiotami przetwarzającymi wiadomości.
  • Umożliwia korzystanie ze statystyk.

Aby wykonać polecenie setup-org:

  1. Zainstaluj apigee-provision w węźle serwera zarządzania:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Uruchom skrypt setup-org w węźle serwera zarządzania i wskaż plik konfiguracji utworzony w sekcji Tworzenie pliku konfiguracji wprowadzenia:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Plik konfiguracji musi być czytelny dla użytkownika „apigee”.

  3. Sprawdź, czy udało Ci się zarejestrować organizację. Możesz to zrobić na przykład, logując się w interfejsie użytkownika, wysyłając żądanie dotyczące tego adresu URL w przeglądarce:
    http://IP_address:9000/login

    Gdzie IP_address to adres IP serwera, na którym zainstalowano interfejs Edge.

    Dodatkowe kroki weryfikacji znajdziesz w artykule Weryfikowanie rejestracji.

  4. Utwórz pierwszy serwer proxy.

Weryfikacja wprowadzenia

Po zakończeniu wprowadzenia sprawdź stan systemu, uruchamiając te polecenia curl w węźle serwera zarządzania:

  1. Sprawdź stan użytkownika i organizacji na serwerze zarządzania, wykonując te polecenia:
    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/org_name/deployments
  2. Sprawdź statystyki, wykonując to polecenie:
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Sprawdź stan bazy danych PostgreSQL, wykonując w węźle 2 te polecenia (jak pokazano w topologii instalacji):
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    W wierszu polecenia wpisz to polecenie, aby wyświetlić tabelę Analytics w organizacji:

    \d analytics."org_name.env_name.fact"

    Użyj tego polecenia, aby zamknąć psql:

    \q
  4. Uzyskaj dostęp do interfejsu Apigee Edge w przeglądarce. Pamiętaj, że na końcu instalacji został zanotowany adres URL konsoli zarządzania.
    1. Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda to podobnie do tego, gdzie adres IP wskazuje węzeł 1 (jak widać w topologii instalacji) lub węzła, w którym zainstalowano interfejs użytkownika na potrzeby alternatywnych konfiguracji:
      http://192.168.56.111:9000/login

      9000 to numer portu używany w interfejsie użytkownika.

      Jeśli uruchamiasz przeglądarkę bezpośrednio na serwerze, na którym jest hostowany interfejs Edge, możesz użyć adresu URL w formacie:

      http://localhost:9000/login

    2. Na stronie logowania się w konsoli podaj nazwę użytkownika i hasło administratora systemu Apigee.
  5. Zarejestruj nowe konto użytkownika Apigee i zaloguj się, używając nowych danych logowania. Na stronie logowania się w konsoli kliknij przycisk Zaloguj się.

    Przeglądarka przekierowuje do http://192.168.56.111:9000/platform/#/org_name/ i otwiera panel, który umożliwia skonfigurowanie utworzonej organizacji (jeśli użytkownik zalogował się przy użyciu danych logowania administratora Apigee).

Utwórz pierwszy serwer proxy

Po zarejestrowaniu nowej organizacji i sprawdzeniu, czy proces wprowadzenia przebiegł pomyślnie, możesz utworzyć pierwszy serwer proxy. Więcej informacji znajdziesz w artykule o tworzeniu pierwszego serwera proxy interfejsu API.

Inne materiały, które mogą Ci się przydać: