Po wdrożeniu
Ta strona stanowi kontynuację wdrożenia. Najpierw należy zakończyć proces wdrożenia.
1. Weryfikacja wdrożenia
1.1 Sprawdzanie rezultatów wdrożenia
Po otwarciu grupy zasobów należy wybrać Deployments, otworzyć wdrożenie, a następnie przejść do sekcji Outputs.
| Wynik | Opis |
|---|---|
appServiceUrl | Adres URL, pod którym dostępny jest AI Analyst |
keyVaultName | Key Vault przechowujący sekrety |
cognitiveServicesName | Konto Azure AI Foundry |
knowledgeHubPrivateLinkState | Czy połączenie z Knowledge Hub zostało zatwierdzone |
1.2 Kontrola aplikacji
- Proszę otworzyć App Service w zarządzanej grupie zasobów.
- Na karcie Overview należy potwierdzić, że Status wskazuje
Running. - Proszę przejść do Monitoring -> Log stream i sprawdzić, czy obraz kontenera został pobrany oraz czy aplikacja uruchomiła się bez błędów.
Jeżeli status to Running i w dzienniku logów nie ma błędów podczas uruchamiania, wdrożenie przebiegło prawidłowo.
Jeśli zakres adresów IP znajduje się na liście dozwolonych, można otworzyć adres URL aplikacji w przeglądarce. Z adresu spoza listy dozwolonych zarówno przeglądarka, jak i API zwrócą 403. Oznacza to poprawne działanie pozwolenia sieciowego, a nie błąd wdrożenia.
1.3 Dostępność bazy danych – sprawdzenie i konfiguracja
AI Analyst korzysta z integracji z siecią wirtualną. Cały ruch wychodzący do Państwa bazy danych przechodzi przez podsieć integracyjną tej sieci. W zależności od lokalizacji bazy danych konieczne jest inne przygotowanie środowiska.
| Lokalizacja bazy danych | Zakres konfiguracji |
|---|---|
| Azure SQL Database z punktem publicznym | Włączenie opcji Allow Azure services and resources to access this server w zakładce sieciowej SQL Server. W celu zwiększenia bezpieczeństwa zamiast tego można dodać do listy dozwolonych tylko adresy IP wyjściowe App Service. |
| Azure SQL Database z punktem prywatnym | Należy zestawić peering sieci wirtualnej z siecią AI Analyst oraz Link strefę DNS privatelink.database.windows.net z siecią AI Analyst, dzięki czemu zostanie prawidłowo rozwiązana prywatna nazwa. |
| MSSQL Server lokalnie (on premises) | Należy zestawić łączność za pośrednictwem App Service Hybrid Connections. |
Oficjalna dokumentacja Microsoft:
- Azure Private Link dla Azure SQL Database
- Tworzenie i użycie hybrydowych połączeń w Azure App Service
Dopóki baza danych nie będzie osiągalna, Azure WebApp podczas uruchamiania loguje Database warm-up failed.
2. Wniosek o zatwierdzenie prywatnego Link
W trakcie wdrożenia tworzony jest prywatny punkt dostępu do dab Knowledge Hub. Połączenie pozostaje w stanie Pending do czasu zatwierdzenia przez dab. W tym czasie AI Analyst pracuje bez wiedzy tła dab.
Proszę przesłać swój Subscription ID oraz wiadomość dotyczącą prośby o prywatny Link, wprowadzoną podczas wdrożenia, do kontaktu dab lub na adres delivery(at)dab-gmbh.de, aby dab mógł zweryfikować oraz zatwierdzić to połączenie.
3. Aktualizacja istniejącego wdrożenia
Aby zmienić ustawienia po wdrożeniu, należy ponownie uruchomić wdrożenie z oferty Marketplace, wybierając tę samą grupę zasobów. Azure zaktualizuje istniejące zasoby na miejscu i zmodyfikuje tylko te właściwości, które ulegają zmianie.
Podczas wdrożenia nie jest możliwe odczytanie już przechowywanych sekretów. Przy każdym ponownym wdrożeniu należy ponownie wprowadzić wszystkie wartości sekretów – nawet przy zmianie tylko listy dozwolonych adresów IP. Aby pozostawić wartości bez zmian, proszę wpisać te same dane, a w celu rotacji – nowe. Puste lub tymczasowe dane spowodują nadpisanie dotychczasowych sekretów i unieruchomią wdrożenie.
Do najczęstszych zmian należą:
- Skalowanie App Service Plan w górę lub w dół
- Dodanie adresów IP do listy dozwolonych (możliwe także bez ponownego wdrożenia w Azure Portal pod App Service -> Networking -> Access restrictions)
- Zmiana modelu lub jego wydajności
- Rotacja AIA API Key lub Session Token Secret
dab nie określa interwału rotacji dla AIA API Key, Session Token Secret ani poświadczeń do bazy danych. Należy je rotować zgodnie z wymogami polityki bezpieczeństwa obowiązującej w Państwa organizacji.
Rotacja nie wymaga ponownego wdrożenia: wystarczy zaktualizować wartość sekretu w Key Vault należącym do Managed Application, a następnie ponownie uruchomić aplikację webową w sekcji App Service -> Przegląd -> Uruchom ponownie. Aplikacja pobiera nową wartość podczas startu.
5. Aktualizacja aplikacji do nowej wersji
dab AI Analyst działa jako obraz kontenera pobierany z rejestru kontenerów dab. Aby zaktualizować do najnowszej wersji, należy ponownie uruchomić aplikację webową w Azure Portal, przechodząc do App Service -> Overview -> Restart. Podczas uruchamiania App Service automatycznie pobierze najnowszy obraz; nie jest wymagane ponowne wdrażanie ani ponowne wprowadzanie sekretów.
Dotyczy to wyłącznie aktualizacji aplikacji. Jeśli nowa wersja wymaga również zmian w infrastrukturze (np. nowych zasobów, ustawień lub uprawnień), dab powiadomi Państwa z wyprzedzeniem oraz przekaże odpowiednie instrukcje. W takiej sytuacji aktualizację należy przeprowadzić poprzez ponowną instalację Managed Application, zgodnie z opisem w sekcji 3.
4. Uzyskanie pomocy
W przypadku niepowodzenia wdrożenia proszę skorzystać z Deployment Issues. Jeżeli aplikacja została wdrożona, ale nie działa zgodnie z oczekiwaniami, zalecamy przejście do Issues After the Deployment.