4.16.05 – informacje o wersji Edge dla Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info

31 maja 2016 r. (wtorek) udostępniliśmy nową wersję Apigee Edge for Private Cloud.

Od poprzedniej wersji funkcji Edge dla chmury prywatnej (4.16.01) pojawiły się te wersje, które są uwzględnione w tej wersji funkcji:

• Chmura: 16.02.17, 16.03.02, 16.03.09 (interfejs), 16.03.16 (interfejs), 16.03.23 (interfejs), 16.03.30

Aby dowiedzieć się, jak sprawdzić, czy konkretna wersja chmury jest uwzględniona w Twojej wersji Edge for Private Cloud, przeczytaj artykuł Informacje o numeracji wersji.

Nowe funkcje i ulepszenia

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji. Oprócz poniższych ulepszeń ta wersja zawiera też wiele ulepszeń dotyczących użyteczności, wydajności, bezpieczeństwa i stabilności.

Więcej informacji i instrukcji znajdziesz w dokumentacji Edge for Private Cloud.

Instrukcje instalacji i obsługi przeniesione do internetu

Przewodnik instalacji i obsługi Edge for Private Cloud jest teraz dostępny w wersji 4.18.01.

Aktualizacje oprogramowania

Ta wersja zawiera te aktualizacje oprogramowania:

• Java JDK 1.8 – aby korzystać z najnowszych funkcji Javy, ta wersja jest zgodna z Java 1.8. W środowisku wymagany jest pakiet Oracle JDK 1.8 lub OpenJDK 8.
  W ramach aktualizacji do Javy 8 niektóre szyfry TLS nie są już dostępne w Oracle JDK 1.8. Pełną listę znajdziesz w sekcji „Default Disabled Cipher Suites” (Domyślnie wyłączone zestawy szyfrów) na stronie http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
• Cassandra 2.1.13 – zaktualizowana z Cassandra 2.0.15.

Instalacja, uaktualnienie, wycofanie

Poniżej znajdziesz listę zmian w skryptach instalacyjnych, skryptach uaktualniania i skryptach powiązanych. Informacje o korzystaniu z tej funkcji znajdziesz w dokumentacji Edge for Private Cloud.

• Nowy proces aktualizacji z wersji 4.16.01 – ta wersja zastępuje narzędzie apigee-migrate narzędziem update.sh, aby zaktualizować instalację z wersji 4.16.01 do wersji 4.16.05. Zobacz Aktualizowanie Apigee Edge 4.16.01 do wersji 4.16.05.
• Bootstrap
  • bootstrap.sh (wersja 4.16.01) jest terazbootstrap_4.16.05.sh w wersji 4.16.05.
  • Nie musisz już podawać uname:pword, aby pobrać bootstrap_4.16.05.sh.
• Cofanie – aby cofnąć aktualizację do wersji 4.16.05, odinstaluj tę wersję komponentu i zainstaluj poprzednią wersję. Poprzednie narzędzie rollback.sh zostało usunięte. Zobacz 4.16.05 Proces wycofywania.
• setup.sh i update.sh mogą zapisywać plik dziennika w /tmp – domyślnie narzędzia setup.sh i update.sh zapisują informacje dziennika w /opt/apigee/var/log/apigee-setup. Jeśli użytkownik uruchamiający narzędzie nie ma dostępu do tego katalogu, zapisuje dziennik w katalogu /tmp. Jeśli użytkownik nie ma dostępu do /tmp, narzędzie nie działa.
• Procedura aktualizacji interfejsu API BaaS – w wersji 4.16.01 interfejs API BaaS trzeba było ponownie zainstalować, aby go przenieść. Nowe narzędzie update.sh umożliwia aktualizowanie interfejsu API BaaS w miejscu. Zobacz Aktualizowanie Apigee Edge 4.16.01 do wersji 4.16.05.

Administracja

Poniżej znajdziesz nowe funkcje administracji i konfiguracji chmury prywatnej.

• Weryfikacja instalacji – narzędzie apigee-validate używane do testowania instalacji Edge Private Cloud można teraz uruchamiać z serwera zarządzania. Wcześniej skrypt musiał być uruchamiany na procesorze wiadomości. Zobacz Testowanie instalacji.
• Nazwa regionu – region może mieć dowolną nazwę. W poprzednich wersjach nazwa miała postać „dc-#”, gdzie # to liczba całkowita.
• Bloki reklamowe bramy – bloki reklamowe bramy mogą mieć dowolną nazwę. W poprzednich wersjach pod musiał mieć nazwę „gateway”.
• Administracja oparta na skryptach – nowe narzędzie wiersza poleceń apigee-adminapi.sh umożliwia wykonywanie tych samych zadań konfiguracyjnych Edge, które wykonujesz, wywołując interfejs Edge Management API. Zobacz Korzystanie z narzędzia apigee-adminapi.sh.
• Cicha konfiguracja SSL hosta wirtualnego – podczas tworzenia organizacji lub środowiska możesz teraz przekazywać właściwości, aby skonfigurować SSL na hoście wirtualnym. Zobacz Wprowadzanie organizacji.

Usługi API

Poniżej znajdziesz nowe funkcje usług API Edge, które zostały udostępnione w poprzednich wersjach produktu w chmurze.

Prefiks o stałej długości do logowania wiadomości syslog (Cloud 16.03.30)

Zasady logowania wiadomości mają nowy element <FormatMessage> w konfiguracji Syslog. Ustawiając wartość <FormatMessage>true</FormatMessage>, możesz sprawić, że wiadomości Syslog będą zaczynać się od stałej liczby znaków, co pozwoli Ci odfiltrować dane wstawione przez Apigee. Więcej informacji znajdziesz w zasadach dotyczących rejestrowania wiadomości. (APIRT-1398)

Wildcard in API proxy Base Path (Cloud 16.03.09 UI)

Interfejs zarządzania obsługuje używanie co najmniej 1 symbolu wieloznacznego /*/ w ścieżkach podstawowych serwera proxy interfejsu API. Na przykład ścieżka podstawowa /team/*/members umożliwia klientom wywoływanie Twojego serwera proxy za pomocą https://[host]/team/blue/members lub https://[host]/team/green/members bez konieczności tworzenia nowego serwera proxy do obsługi nowych zespołów. Pamiętaj, że /**/ jest niedozwolone. (MGMT-3154)

Łączenie serwerów proxy API (Cloud 16.03.02, interfejs Cloud 16.03.09)

Edge obsługuje lokalne łączenie proxy interfejsu API, co umożliwia jednemu proxy interfejsu API wywoływanie innego proxy interfejsu API wdrożonego w organizacji Edge bez dodatkowych obciążeń sieciowych. Wcześniej łączenie łańcuchów serwerów proxy interfejsu API wymagało wywołania http(s) innego serwera proxy interfejsu API, który przekazywał żądanie przez moduł równoważenia obciążenia, router i procesor wiadomości.

W punkcie końcowym docelowym serwera proxy API dostępne są nowe elementy LocalTargetConnection, które umożliwiają określenie nazwy serwera proxy API, nazwy konkretnego punktu końcowego serwera proxy w serwerze proxy API lub po prostu ścieżki podstawowej do lokalnego zasobu serwera proxy API (np. /v1/myresource). Interfejs edytora serwera proxy udostępnia też te opcje, gdy dodajesz lub aktualizujesz TargetEndpoint.

Łączenie serwerów proxy jest też dostępne w zasadach wywołania usługi.

Więcej informacji znajdziesz w artykule Łączenie ze sobą proxy interfejsów API. Nowe elementy LocalTargetConnection są też wymienione w schemacie XML: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Usunięte błędy

W tej wersji naprawiliśmy te błędy: Ta lista jest przeznaczona głównie dla użytkowników, którzy chcą sprawdzić, czy ich zgłoszenia zostały rozwiązane. Nie jest on przeznaczony do dostarczania szczegółowych informacji wszystkim użytkownikom.

Edge for Private Cloud 4.16.05

Cloud 16.03.30

Interfejs Cloud 16.03.16

Interfejs Cloud 16.03.09

Cloud 16.03.02

Cloud 16.02.17

Znane problemy

W tej wersji występują te znane problemy.

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Ładunki JSON w zasadach Assign Message, Java Callout i Raise Fault

Zasady Assign Message, Java Callout i Raise Fault umożliwiają generowanie treści wiadomości za pomocą elementu <Set><Payload>. W ramach tych wiadomości możesz uwzględniać zmienne, których wartości są automatycznie wypełniane w czasie działania programu. Jeśli na przykład chcesz wyświetlić datę z nagłówka HTTP, możesz wstawić do wiadomości {message.header.date}.

Jeśli format wiadomości to JSON, będzie ona wyglądać mniej więcej tak:

{"The date is: " : "{message.header.date}"}

Możesz jednak zauważyć, że jest to nieprawidłowy kod JSON. Aby obejść ten problem, masz 2 możliwości:

• Zmień znaczenie otwierającego nawiasu klamrowego za pomocą ukośnika lewego:

  \{"The date is: " : "{message.header.date}"}

• W konfiguracji elementu Payload (Ładunek) użyj atrybutów variablePrefix i variableSuffix, aby wskazać zmienną w ładunku JSON. Na przykład:
  

  <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

W kolejnej wersji Edge for Private Cloud będzie można bez problemu używać nawiasów klamrowych w przypadku zmiennych w wiadomościach JSON. (APIRT-1160)

Nie udało się uruchomić Nginx lub nie udało się uruchomić routera

Jeśli router brzegowy nie uruchomi Nginx lub nie uruchomi się wcale, jak pokazano w pliku /opt/apigee/var/log/edge-router/logs/system.log, usuń wszystkie pliki w katalogu /opt/nginx/conf.d i ponownie uruchom router:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart