Ta strona została przetłumaczona przez Cloud Translation API.

Rejestrowanie organizacji

Edge for Private Cloud w wersji 4.19.01

Aby wdrożyć organizację, musisz utworzyć plik konfiguracji wdrożenia, a następnie przekazać go do polecenia setup-org. Każdy z tych kroków jest opisany w dalszych sekcjach.

Informacje o korzystaniu z interfejsu Management API do rejestrowania organizacji znajdziesz w artykule Tworzenie organizacji, środowiska i hosta wirtualnego.

Tworzenie pliku konfiguracji wdrożenia

Ta sekcja zawiera przykładowy plik konfiguracji służący do wprowadzania organizacji w setup-org.

Skopiuj ten przykład i w razie potrzeby dostosuj go do 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:

Jeśli w przypadku VHOST_ALIAS masz już rekord DNS, którego będziesz używać do uzyskiwania dostępu do hosta wirtualnego, podaj alias hosta i opcjonalnie port, na przykład „myapi.example.com”. Jeśli nie masz jeszcze rekordu DNS, możesz użyć adresu IP routera.

Więcej informacji o konfigurowaniu hosta wirtualnego znajdziesz w artykule Konfigurowanie hosta wirtualnego.
Informacje o konfiguracji TLS/SSL znajdziesz w sekcjach dotyczących magazynów kluczy i magazynów zaufania oraz konfigurowania dostępu TLS do interfejsu API na potrzeby chmury prywatnej, w których znajdziesz więcej informacji o tworzeniu pliku JAR i innych aspektach konfigurowania TLS/SSL.
Więcej informacji o konfigurowaniu hostów wirtualnych znajdziesz w artykule Konfigurowanie dostępu TLS do interfejsu API w Private Cloud.
Nie można utworzyć dwóch organizacji o tej samej nazwie. W takim przypadku drugie utworzenie zakończy się niepowodzeniem.

Wykonaj polecenie setup-org.

Po utworzeniu pliku konfiguracji procesu wprowadzania możesz go przekazać do skryptu setup-org, aby przeprowadzić proces wprowadzania. Skrypt musisz uruchomić na węźle serwera zarządzania.

Podczas wdrażania organizacji skrypt setup-org wykonuje te czynności:

Tworzy nową organizację.
Tworzy środowisko.
Tworzy hosta wirtualnego dla środowiska.
Ustawia wskazanego użytkownika jako administratora organizacji. Pamiętaj, że:
- Możesz użyć dotychczasowego użytkownika lub utworzyć nowego dla administratora organizacji.
- Administrator organizacji nie może być taki sam jak administrator systemu sys.
Powiązuje organizację z podzbiorem „gateway”. (jest to ustawienie domyślne i nie można go zmienić).
Łączy środowisko ze wszystkimi procesorami wiadomości.
Włącza funkcję analityki.

Aby wykonać setup-org:

Zainstaluj apigee-provision na węźle serwera zarządzania:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision install

Uruchom skrypt setup-org na węźle serwera zarządzania i skieruj go na plik konfiguracji utworzony w Tworzenie pliku konfiguracji onboardingu:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
Plik konfiguracji musi być czytelny dla użytkownika „apigee”.
Sprawdź, czy organizacja została dodana. Jednym ze sposobów jest zalogowanie się w interfejsie, prosząc o adres URL w przeglądarce:
```
http://IP_address:9000/login
```
Gdzie IP_address to adres IP serwera, na którym zainstalowano interfejs użytkownika Edge.

Więcej informacji o dodatkowych krokach weryfikacji znajdziesz w artykule Weryfikowanie procesu rejestracji.
Utwórz pierwsze proxy!

weryfikowanie procesu wdrożenia,

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

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

Sprawdź statystyki, wykonując to polecenie:

curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

Sprawdź stan bazy danych PostgreSQL, wykonując te polecenia na węźle 2 (jak pokazano w topologii instalacji):
```
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
```
Aby wyświetlić tabelę analityczną organizacji, w wierszu poleceń wpisz to polecenie:
```
\d analytics."org_name.env_name.fact"
```
Aby wyjść z psql, użyj tego polecenia:
```
\q
```
Otwórz interfejs Apigee Edge w przeglądarce. Pamiętaj, że na końcu instalacji został już zapisany adres URL konsoli zarządzania.
1. Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda ono podobnie do tego: adres IP jest adresem węzła 1 (jak w topologiach instalacji) lub dowolnego węzła, na którym 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, na którym hostowany jest interfejs Edge, możesz użyć adresu URL w formie:
```
http://localhost:9000/login
```
  Uwaga: upewnij się, że port 9000 jest otwarty. Jeśli korzystasz z usługi takiej jak Google Cloud Engine, konieczne może być zmodyfikowanie zasad zapory sieciowej, aby uzyskać dostęp do usług Apigee przez przeglądarkę.
2. Na stronie logowania do konsoli podaj nazwę użytkownika i hasło administratora systemu Apigee.
  Uwaga: to hasło globalnego administratora systemu zostało ustawione podczas instalacji.
Zarejestruj nowe konto użytkownika Apigee i użyj nowych danych logowania, aby się zalogować. Na stronie logowania do konsoli kliknij przycisk Zaloguj się.

Przeglądarka przekieruje Cię na stronę http://192.168.56.111:9000/platform/#/org_name/i otworzy panel, w którym możesz skonfigurować utworzoną organizację (jeśli zalogujesz się przy użyciu danych logowania administratora Apigee).

Tworzenie pierwszego serwera proxy

Po zarejestrowaniu nowej organizacji i potwierdzeniu, że proces wdrażania przebiegł pomyślnie, możesz utworzyć swój pierwszy serwer proxy. Więcej informacji znajdziesz w artykule Tworzenie pierwszego serwera proxy interfejsu API.

Inne przydatne materiały: