4.16.05 – informacje o wersji Edge dla Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

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

Od poprzedniej wersji funkcji Edge for Private Cloud (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

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

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

Przewodniki instalacji i obsługi przeniesione do internetu

Przewodnik instalacji i obsługi Edge dla chmury prywatnej jest teraz dostępny w wersji 4.18.01.

Aktualizacje oprogramowania

W tej wersji uwzględniono te aktualizacje oprogramowania:

• Java JDK 1.8 – aby korzystać z najnowszych funkcji Javy, ta wersja jest zgodna z Java 1.8. W środowisku musi być zainstalowany 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 wersji Cassandra 2.0.15.

Instalacja, uaktualnianie, wycofywanie

Poniżej znajdziesz listę zmian w skryptach instalacyjnych, skryptach uaktualniania i skryptach powiązanych. Informacje o używaniu 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 4.16.05. Zobacz Aktualizowanie Apigee Edge 4.16.01 do wersji 4.16.05.
• Bootstrap
  • bootstrap.sh (wersja 4.16.01) jest teraz bootstrap_4.16.05.sh w wersji 4.16.05.
  • Aby pobrać bootstrap_4.16.05.sh, nie musisz już podawać uname:pword.
• Przywracanie – aby przywrócić aktualizację do wersji 4.16.05, odinstaluj komponent w wersji 4.16.05 i zainstaluj ponownie poprzednią wersję. Poprzednie narzędzie rollback.sh zostało usunięte. Zobacz 4.16.05 Proces wycofywania zmian.
• 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 trzeba było ponownie zainstalować interfejs API BaaS, 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 chmurą prywatną i jej konfiguracji.

• Weryfikacja instalacji – narzędzie apigee-validate służące do testowania instalacji Edge Private Cloud można teraz uruchamiać z serwera zarządzania. Wcześniej skrypt musiał być uruchamiany na procesorze komunikatów. Zobacz Testowanie instalacji.
• Nazwa regionu – region może mieć dowolną nazwę. W poprzednich wersjach nazwa miała postać „dc-#”, gdzie # to liczba całkowita.
• Gateway pods – Gateway pods mogą mieć dowolną nazwę. W poprzednich wersjach pod musiał mieć nazwę „gateway”.
• Administrowanie oparte 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 Edge API, które zostały udostępnione w poprzednich wersjach produktu w chmurze.

Prefiks o stałej długości do logowania komunikatów 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)

Symbol wieloznaczny w podstawowej ścieżce proxy interfejsu API (interfejs Cloud 16.03.09)

Interfejs zarządzania obsługuje używanie co najmniej 1 symbolu wieloznacznego /*/ w ścieżkach podstawowych 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 interfejsu 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 Twojej organizacji Edge bez dodatkowych obciążeń sieciowych. Wcześniej łączenie w łańcuch proxy interfejsu API wymagało wywołania http(s) innego proxy interfejsu API, który przekazywał żądanie przez system równoważenia obciążenia, router i procesor komunikatów.

W elemencie TargetEndpoint proxy interfejsu API dostępne są nowe elementy LocalTargetConnection, które umożliwiają określenie nazwy proxy interfejsu API, nazwy konkretnego elementu ProxyEndpoint w proxy interfejsu API lub po prostu ścieżki podstawowej do lokalnego zasobu proxy interfejsu API (np. /v1/myresource). Interfejs edytora serwera proxy udostępnia też te opcje, gdy dodajesz lub aktualizujesz element TargetEndpoint.

Łączenie 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)

Poprawione 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 dla chmury prywatnej 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 wartość {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}"}

Widać jednak, że jest to nieprawidłowy format JSON. Aby obejść ten problem, masz 2 opcje:

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

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

• W konfiguracji elementu Ł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ę w ogóle, 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