4.16.05 – informacje o wersji Edge dla Private Cloud

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

We wtorek 31 maja 2016 roku opublikowaliśmy nową wersję Apigee Edge dla Private Cloud.

Od poprzedniej wersji funkcji Edge for Private Cloud (4.16.01) pojawiły się następujące wersje, które są uwzględnione w tej wersji funkcji:

• Cloud: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30

Zapoznaj się z artykułem Informacje o numerowaniu wersji, aby dowiedzieć się, jak sprawdzić, czy konkretna wersja chmury jest uwzględniona w Twojej wersji Edge dla Private Cloud.

Nowe funkcje i ulepszenia

Poniżej znajdziesz opis nowych funkcji i ulepszeń wprowadzanych w tej wersji. Oprócz poniższych ulepszeń ta wersja zawiera też wiele ulepszeń w zakresie łatwości obsługi, wydajności, bezpieczeństwa i stabilności.

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

Przewodniki dotyczące instalacji i operacji zostały przeniesione do internetu

Przewodnik instalacji i operacji przeglądarki Edge dla chmury prywatnej jest dostępny w wersji 4.18.01.

Aktualizacje oprogramowania

Wersja zawiera te aktualizacje oprogramowania:

• Java JDK 1.8 – ta wersja jest zgodna z Java 1.8, aby umożliwić korzystanie z najnowszych funkcji Javy. W Twoim środowisku jest wymagane Oracle JDK 1.8 lub OpenJDK 8.
  W ramach aktualizacji do Javy 8 niektóre mechanizmy szyfrowania TLS nie są już dostępne w Oracle JDK 1.8. Pełną listę znajdziesz w sekcji „Domyślne wyłączone pakiety szyfrów” http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
• Cassandra 2.1.13 – zaktualizowana wersja Cassandra 2.0.15.

Instalacja, uaktualnienie, przywrócenie

Poniżej znajduje się lista zmian wprowadzonych w instalacji, uaktualnianiu i powiązanych skryptach. Informacje o korzystaniu z tej usługi znajdziesz w dokumentacji Edge for Private Cloud.

• Nowy proces aktualizacji z wersji 4.16.01 – w tej wersji narzędzie apigee-migrate zastępuje narzędzie update.sh aktualizacją z wersji 4.16.01 do 4.16.05. Zobacz aktualizację Apigee Edge z wersji 4.16.01 do wersji 4.16.05.
• Wczytywanie
  • bootstrap.sh (wersja 4.16.01) to teraz bootstrap_4.16.05.sh w wersji 4.16.05.
  • Nie musisz już określać uname:pword, aby pobrać bootstrap_4.16.05.sh.
• 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. Patrz 4.16.05 Proces przywracania.
• setup.sh i update.sh mogą zapisać plik dziennika w /tmp – domyślnie narzędzia setup.sh i update.sh zapisują informacje logu 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 usługi /tmp, narzędzie ulegnie awarii.
• Procedura aktualizacji interfejsu API BaaS – w wersji 4.16.01 trzeba było ponownie zainstalować API BaaS, aby go przenieść. Nowe narzędzie update.sh obsługuje aktualizowanie interfejsu API BaaS. Zobacz aktualizację Apigee Edge z wersji 4.16.01 do wersji 4.16.05.

Administracja

Poniżej znajdziesz nowe funkcje związane z administrowaniem i konfigurowaniem Private Cloud.

• Weryfikacja instalacji – narzędzie apigee-validate używane do testowania instalacji chmury prywatnej brzegowej można teraz uruchamiać z serwera zarządzania. Wcześniej skrypt musiał być uruchamiany w procesorze wiadomości. Zapoznaj się z sekcją Testowanie instalacji.
• Nazwa regionu – region może być dowolną nazwą. W poprzednich wersjach nazwa miała postać „dc-#”, gdzie # jest liczbą całkowitą.
• Pody bramy – pody bramy mogą mieć dowolną nazwę. W poprzednich wersjach pod musi mieć nazwę „brama”.
• Administracja oparta na skryptach – nowe narzędzie wiersza poleceń apigee-adminapi.sh umożliwia wykonywanie tych samych zadań konfiguracji brzegowych, które są wykonywane przez wywołania interfejsu Edge Management API. Zapoznaj się z artykułem o używaniu narzędzia apigee-adminapi.sh.
• Dyskretna konfiguracja hosta wirtualnego SSL – podczas tworzenia organizacji lub środowiska możesz teraz przekazywać właściwości w celu skonfigurowania SSL na hoście wirtualnym. Zobacz Wdrażanie organizacji.

Usługi interfejsu API

Poniżej znajdziesz nowe funkcje usług Edge API, które były dostępne w poprzednich wersjach usługi działających w chmurze.

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

Zasada logowania wiadomości ma w konfiguracji Syslog nowy element <FormatMessage>. Gdy ustawisz <FormatMessage>true</FormatMessage>, komunikaty syslog rozpoczynają się od stałej liczby znaków, co pozwala odfiltrowywać dane wstawione przez Apigee. Więcej informacji znajdziesz w artykule o zasadach logowania wiadomości. (APIRT-1398)

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

Interfejs zarządzania obsługuje używanie co najmniej 1 symbolu wieloznacznygo /*/ w ścieżkach bazowych serwera proxy interfejsu API. Na przykład ścieżka bazowa /team/*/members pozwala klientom wywoływać serwer 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 zasada /**/ jest niedozwolona. (MGMT-3154)

Łańcuch proxy interfejsów API (Cloud 16.03.02, Cloud 16.03.09 UI)

Edge obsługuje łańcuch lokalnych serwerów proxy interfejsów API, co umożliwia jednemu serwerowi proxy interfejsu API wywoływanie innego serwera proxy interfejsu API wdrożonego w organizacji brzegowej bez dodatkowego obciążenia sieci. Wcześniej łańcuch serwerów proxy interfejsu API wymagał wywołania http(s) innego serwera proxy interfejsu API, które przekazuje żądanie przez system równoważenia obciążenia, router i procesor wiadomości.

W punkcie końcowym interfejsu API serwera proxy dostępne są nowe elementy LocalTargetConnection. Pozwalają one określić nazwę serwera proxy interfejsu API, nazwę konkretnego punktu ProxyEndpoint na serwerze proxy interfejsu API lub po prostu ścieżkę podstawową do lokalnego zasobu proxy interfejsu API (np. /v1/myresource). Interfejs edytora serwera proxy udostępnia te opcje także podczas dodawania lub aktualizowania punktu końcowego docelowego.

Tworzenie łańcuchów serwerów proxy jest też dostępne w zasadach dotyczących objaśnień usługi.

Więcej informacji znajdziesz w artykule o łączeniu serwerów proxy interfejsu API łańcucha. Nowe elementy LocalTargetConnection są też wymienione w schemacie XML tutaj: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Naprawione błędy

Poprawiliśmy w niej wymienione niżej błędy. Ta lista jest przeznaczona głównie dla użytkowników, którzy chcą sprawdzić, czy ich zgłoszenia do zespołu pomocy zostały rozwiązane. Jej zadaniem nie jest dostarczanie szczegółowych informacji o wszystkich użytkownikach.

Edge dla 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ą opisane poniżej znane problemy.

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

Ładunki JSON w zasadach przypisywania wiadomości, objaśnień w języku Java i podnoszenia błędów

Zasady przypisywania wiadomości, objaśnień Java i zgłaszania błędów umożliwiają generowanie treści wiadomości z użyciem elementu <Set><Payload>. Do tych komunikatów możesz dołączyć zmienne, których wartości są automatycznie wypełniane w czasie działania. Jeśli na przykład chcesz uzyskać datę z nagłówka HTTP, możesz wstawić w wiadomości {message.header.date}.

Wiadomość w formacie JSON wygląda mniej więcej tak:

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

Widać jednak, że jest to format JSON. Aby obejść ten problem, masz 2 możliwości:

• Aby wyjść z otwierającego nawiasu klamrowego, użyj odwróconego ukośnika:

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

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

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

W kolejnej wersji funkcji Edge dla chmury prywatnej będzie można bez problemu używać nawiasów klamrowych dla zmiennych w wiadomościach JSON. (APIRT-1160)

Router nie uruchamia się Nginx lub router nie uruchamia się

Jeśli router brzegowy nie uruchamia Nginx lub w ogóle nie uruchamia się, jak widać w pliku /opt/apigee/var/log/edge-router/logs/system.log, usuń wszystkie pliki z 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