Zarządzanie aplikacją funkcji

W usłudze Azure Functions aplikacja funkcji udostępnia kontekst wykonywania poszczególnych funkcji. Zachowania aplikacji funkcji mają zastosowanie do wszystkich funkcji hostowanych przez daną aplikację funkcji. Wszystkie funkcje w aplikacji funkcji muszą być w tym samym języku.

Poszczególne funkcje w aplikacji funkcji są wdrażane razem i są skalowane razem. Wszystkie funkcje w tej samej aplikacji funkcji współdzielą zasoby na wystąpienie, co aplikacja funkcji skaluje.

Parametry połączenia, zmienne środowiskowe i inne ustawienia aplikacji są definiowane oddzielnie dla każdej aplikacji funkcji. Wszystkie dane, które muszą być współużytkowane przez aplikacje funkcji, powinny być przechowywane zewnętrznie w utrwalonej magazynie.

Rozpocznij pracę w witrynie Azure Portal

Uwaga

Ze względu na ograniczenia dotyczące edytowania kodu funkcji w witrynie Azure Portal należy opracowywać funkcje lokalnie i publikować projekt kodu w aplikacji funkcji na platformie Azure. Aby uzyskać więcej informacji, zobacz Ograniczenia programistyczne w witrynie Azure Portal

Aby wyświetlić ustawienia aplikacji w aplikacji funkcji, wykonaj następujące kroki:

1. Zaloguj się w witrynie Azure Portal przy użyciu konta platformy Azure. Wyszukaj aplikację funkcji i wybierz ją.

2. W lewym okienku aplikacji funkcji rozwiń węzeł Ustawienia, wybierz pozycję Zmienne środowiskowe, a następnie wybierz kartę Ustawienia aplikacji.

   

Praca z ustawieniami aplikacji

Oprócz wstępnie zdefiniowanych ustawień aplikacji używanych przez usługę Azure Functions można utworzyć dowolną liczbę ustawień aplikacji zgodnie z wymaganiami kodu funkcji. Aby uzyskać więcej informacji, zobacz Dokumentacja ustawień aplikacji dla usługi Azure Functions.

Te ustawienia są przechowywane jako zaszyfrowane. Aby uzyskać więcej informacji, zobacz Zabezpieczenia ustawień aplikacji.

Ustawienia aplikacji można zarządzać w witrynie Azure Portal i przy użyciu interfejsu wiersza polecenia platformy Azure i programu Azure PowerShell. Możesz również zarządzać ustawieniami aplikacji za pomocą programu Visual Studio Code i programu Visual Studio.

Witryna Azure Portal

Aby wyświetlić ustawienia aplikacji, zobacz Rozpoczynanie pracy w witrynie Azure Portal.

Karta Ustawienia aplikacji obsługuje ustawienia używane przez aplikację funkcji:

1. Aby wyświetlić wartości ustawień aplikacji, wybierz pozycję Pokaż wartości.

2. Aby dodać ustawienie, wybierz pozycję + Dodaj, a następnie wprowadź nazwę i wartość nowej pary klucz-wartość.

   

Interfejs wiersza polecenia platformy Azure

Polecenie az functionapp config appsettings list zwraca istniejące ustawienia aplikacji, na przykład:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

Polecenie az functionapp config appsettings set dodaje lub aktualizuje ustawienie aplikacji. Poniższy przykład tworzy ustawienie z kluczem o nazwie CUSTOM_FUNCTION_APP_SETTING i wartością 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Azure PowerShell

Polecenie Get-AzFunctionAppSetting cmdlet zwraca istniejące ustawienia aplikacji, na przykład:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

Polecenie Update-AzFunctionAppSetting dodaje lub aktualizuje ustawienie aplikacji. Poniższy przykład tworzy ustawienie z kluczem o nazwie CUSTOM_FUNCTION_APP_SETTING i wartością 12345:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Korzystanie z ustawień aplikacji

Wartości ustawień aplikacji funkcji można również odczytywać w kodzie jako zmienne środowiskowe. Aby uzyskać więcej informacji, zobacz sekcję Zmienne środowiskowe w tych artykułach referencyjnych specyficznych dla języka:

• Wstępnie skompilowane środowisko C#
• Skrypt języka C# (csx)
• Java
• JavaScript
• Program PowerShell
• Python

Podczas lokalnego tworzenia aplikacji funkcji należy zachować lokalne kopie tych wartości w pliku projektu local.settings.json . Aby uzyskać więcej informacji, zobacz Plik ustawień lokalnych.

Ustawienia wdrażania usługi FTPS

Usługa Azure Functions obsługuje wdrażanie kodu projektu w aplikacji funkcji przy użyciu protokołu FTPS. Ponieważ ta metoda wdrażania wymaga synchronizacji wyzwalaczy, nie jest zalecana. Aby bezpiecznie przesyłać pliki projektu, zawsze używaj protokołów FTPS, a nie FTP.

Aby uzyskać poświadczenia wymagane do wdrożenia usługi FTPS, użyj jednej z następujących metod:

Witryna Azure Portal

Poświadczenia publikowania FTPS można pobrać w witrynie Azure Portal, pobierając profil publikowania dla aplikacji funkcji.

Ważne

Profil publikowania zawiera ważne poświadczenia zabezpieczeń. Zawsze zabezpieczaj pobrany plik na komputerze lokalnym.

Aby pobrać profil publikowania aplikacji funkcji:

1. W witrynie Azure Portal znajdź stronę aplikacji funkcji, rozwiń węzeł Konfiguracja ustawień>w lewej kolumnie.

2. Na stronie Konfiguracja wybierz kartę Ustawienia ogólne i upewnij się, że poświadczenia publikowania uwierzytelniania podstawowego programu SCM są włączone. Jeśli to ustawienie jest wyłączone, nie można używać profilów publikowania, dlatego wybierz pozycję Włączone, a następnie pozycję Zapisz.

3. Wróć do strony Przegląd aplikacji funkcji, a następnie wybierz pozycję Pobierz profil publikowania.

   

4. Zapisz i skopiuj zawartość pliku.

3. W pliku znajdź publishProfile element z atrybutem publishMethod="FTP". W tym elemecie publishUrlatrybuty , userNamei userPWD zawierają docelowy adres URL i poświadczenia publikowania FTPS.

Interfejs wiersza polecenia platformy Azure

Uruchom to polecenie interfejsu wiersza polecenia platformy Azure, które zwraca poświadczenia FTPS z profilu publikowania.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

W tym przykładzie zastąp <APP_NAME> ciąg nazwą aplikacji funkcji i <GROUP_NAME> grupą zasobów. Zwrócone URLkolumny , usernamei password zawierają docelowy adres URL i poświadczenia publikowania FTPS.

Azure PowerShell

Uruchom to polecenie programu Azure PowerShell, które zwraca poświadczenia FTPS z profilu publikowania.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

W tym przykładzie zastąp <APP_NAME> ciąg nazwą aplikacji funkcji i <GROUP_NAME> grupą zasobów. Zwrócone URLkolumny , usernamei password zawierają docelowy adres URL i poświadczenia publikowania FTPS.

Typ planu hostingu

Podczas tworzenia aplikacji funkcji utworzysz również plan hostingu, w którym działa aplikacja. Plan może mieć co najmniej jedną aplikację funkcji. Funkcje, skalowanie i cennik funkcji zależą od typu planu. Aby uzyskać więcej informacji, zobacz Opcje hostingu usługi Azure Functions.

Typ planu używanego przez aplikację funkcji można określić w witrynie Azure Portal lub przy użyciu interfejsu wiersza polecenia platformy Azure lub interfejsów API programu Azure PowerShell.

Następujące wartości wskazują typ planu:

Typ planu	Azure Portal	Interfejs wiersza polecenia platformy Azure/program PowerShell
Zużycie	Zużycie	Dynamic
Premium	ElasticPremium	ElasticPremium
Dedykowane (App Service)	Różne	Różne

Witryna Azure Portal

1. Aby określić typ planu używanego przez aplikację funkcji, zobacz plan usługi App Service na stronie Przegląd aplikacji funkcji w witrynie Azure Portal.

   

2. Aby wyświetlić warstwę cenową, wybierz nazwę planu usługi App Service, a następnie wybierz pozycję Właściwości ustawień > w okienku po lewej stronie.

Interfejs wiersza polecenia platformy Azure

Uruchom następujące polecenie interfejsu wiersza polecenia platformy Azure, aby uzyskać typ planu hostingu:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

W poprzednim przykładzie zastąp <RESOURCE_GROUP> wartości i <FUNCTION_APP_NAME> odpowiednio nazwami grup zasobów i aplikacji funkcji.

Azure PowerShell

Uruchom następujące polecenie programu Azure PowerShell, aby uzyskać typ planu hostingu:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

W poprzednim przykładzie zastąp <RESOURCE_GROUP> wartości i <FUNCTION_APP_NAME> odpowiednio nazwami grup zasobów i aplikacji funkcji.

Planowanie migracji

Aplikację funkcji można migrować między planem Zużycie i planem Premium w systemie Windows. Podczas migracji między planami należy pamiętać o następujących kwestiach:

• Bezpośrednia migracja do dedykowanego planu (App Service) nie jest obsługiwana.
• Migracja nie jest obsługiwana w systemie Linux.
• Plan źródłowy i plan docelowy muszą znajdować się w tej samej grupie zasobów i regionie geograficznym. Aby uzyskać więcej informacji, zobacz Przenoszenie aplikacji do innego planu usługi App Service.
• Określone polecenia interfejsu wiersza polecenia zależą od kierunku migracji.
• Przestój w wykonaniach funkcji występuje, gdy aplikacja funkcji jest migrowana między planami.
• Stan i inna zawartość specyficzna dla aplikacji jest utrzymywana, ponieważ ten sam udział usługi Azure Files jest używany przez aplikację zarówno przed migracją, jak i po migracji.

Plan można migrować przy użyciu następujących narzędzi:

Witryna Azure Portal

Aby przełączyć się do innego planu, możesz użyć witryny Azure Portal .

Interfejs wiersza polecenia platformy Azure

Polecenia interfejsu wiersza polecenia platformy Azure umożliwiają ręczne utworzenie nowego planu, przełączenie aplikacji w celu użycia nowego planu i usunięcie oryginalnego planu.

Azure PowerShell

Polecenia programu Azure PowerShell umożliwiają ręczne tworzenie nowego planu, przełączanie aplikacji w celu korzystania z nowego planu i usuwanie oryginalnego planu.

Wybierz kierunek migracji aplikacji w systemie Windows.

Zużycie do warstwy Premium

1. W witrynie Azure Portal przejdź do aplikacji Plan zużycie i wybierz pozycję Zmień plan usługi App Service w obszarze Plan usługi App Service.

2. Wybierz pozycję Premium w obszarze Typ planu, utwórz nowy plan Premium i wybierz przycisk OK.

Aby uzyskać więcej informacji, zobacz Przenoszenie aplikacji do innego planu usługi App Service.

Premium-to-Consumption

1. W witrynie Azure Portal przejdź do aplikacji planu Premium i wybierz pozycję Zmień plan usługi App Service w obszarze Plan usługi App Service.

2. Wybierz pozycję Zużycie w obszarze Typ planu, utwórz nowy plan Zużycie i wybierz przycisk OK.

Aby uzyskać więcej informacji, zobacz Przenoszenie aplikacji do innego planu usługi App Service.

Zużycie do warstwy Premium

Aby przeprowadzić migrację z planu Zużycie do planu Premium w systemie Windows, wykonaj następującą procedurę:

1. Uruchom polecenie az functionapp create w następujący sposób, aby utworzyć nowy plan usługi App Service (Elastic Premium) w tym samym regionie i grupie zasobów co istniejąca aplikacja funkcji:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. Uruchom polecenie az functionapp update w następujący sposób, aby przeprowadzić migrację istniejącej aplikacji funkcji do nowego planu Premium:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. Jeśli nie potrzebujesz już planu Zużycie pierwotnie używanego przez aplikację, usuń oryginalny plan po pomyślnym przeprowadzeniu migracji do nowego. Uruchom polecenie az functionapp plan list w następujący sposób, aby uzyskać listę wszystkich planów Zużycie w grupie zasobów:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

   Możesz bezpiecznie usunąć plan z zerowymi lokacjami, czyli z poziomu zmigrowanych lokacji.

4. Uruchom polecenie az functionapp plan delete w następujący sposób, aby usunąć plan zużycie, z którego przeprowadzono migrację.

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Premium-to-Consumption

Aby przeprowadzić migrację z planu Premium do planu Zużycie w systemie Windows, wykonaj następującą procedurę:

1. Uruchom polecenie az functionapp create w następujący sposób, aby utworzyć nową aplikację funkcji (Zużycie) w tym samym regionie i grupie zasobów co istniejąca aplikacja funkcji. To polecenie tworzy również nowy plan Zużycie, w którym działa aplikacja funkcji:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. Uruchom polecenie az functionapp show w następujący sposób, aby uzyskać nazwę planu Zużycie utworzonego przy użyciu nowej aplikacji funkcji:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   Nazwa planu Zużycie to końcowy segment w pełni kwalifikowanego identyfikatora zasobu, który jest zwracany.

3. Uruchom polecenie az functionapp update w następujący sposób, aby zmigrować istniejącą aplikację funkcji do nowego planu Zużycie:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. Uruchom polecenie az functionapp delete w następujący sposób, aby usunąć aplikację funkcji utworzoną w kroku 1, ponieważ potrzebny jest tylko plan, który został utworzony do uruchomienia istniejącej aplikacji funkcji:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. Jeśli nie potrzebujesz już planu Premium pierwotnie używanego przez aplikację, usuń oryginalny plan po potwierdzeniu pomyślnej migracji do nowego planu. Dopóki plan Premium nie zostanie usunięty, opłaty będą nadal naliczane. Uruchom polecenie az functionapp plan list w następujący sposób, aby uzyskać listę wszystkich planów Premium w grupie zasobów:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. Uruchom polecenie az functionapp plan delete w następujący sposób, aby usunąć plan Premium, z którego przeprowadzono migrację:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

Zużycie do warstwy Premium

Aby przeprowadzić migrację z planu Zużycie do planu Premium w systemie Windows, wykonaj następującą procedurę:

1. Uruchom polecenie New-AzFunctionAppPlan w następujący sposób, aby utworzyć nowy plan usługi App Service (Elastic Premium) w tym samym regionie i grupie zasobów co istniejąca aplikacja funkcji:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. Uruchom polecenie Update-AzFunctionApp w następujący sposób, aby zmigrować istniejącą aplikację funkcji do nowego planu Premium:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. Jeśli nie potrzebujesz już planu Zużycie pierwotnie używanego przez aplikację, możesz uruchomić polecenie Remove-AzFunctionAppPlan w następujący sposób, aby usunąć plan zużycie, z którego przeprowadzono migrację:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Premium-to-Consumption

Aby przeprowadzić migrację z planu Premium do planu Zużycie w systemie Windows, wykonaj następującą procedurę:

1. Uruchom polecenie New-AzFunctionApp w następujący sposób, aby utworzyć nową aplikację funkcji (Zużycie) w tym samym regionie i grupie zasobów co istniejąca aplikacja funkcji. To polecenie tworzy również nowy plan Zużycie, w którym działa aplikacja funkcji:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. Uruchom polecenie Get-AzFunctionApp w następujący sposób, aby uzyskać nazwę planu Zużycie utworzonego przy użyciu nowej aplikacji funkcji:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. Uruchom polecenie Update-AzFunctionApp w następujący sposób, aby zmigrować istniejącą aplikację funkcji do nowego planu Zużycie:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. Jeśli nie potrzebujesz już planu Zużycie pierwotnie używanego przez aplikację, możesz uruchomić polecenie Remove-AzFunctionAppPlan w następujący sposób, aby usunąć plan zużycie, z którego przeprowadzono migrację:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Ograniczenia programistyczne w witrynie Azure Portal

W poniższej tabeli przedstawiono systemy operacyjne i języki, które obsługują edycję w portalu:

Język	Zużycie w systemie Windows	Windows Premium	Windows Dedicated	Zużycie w systemie Linux	Linux Premium	Linux Dedicated
C#
Java
JavaScript (Node.js)	✔	✔	✔		✔	✔
Python				✔	✔	✔
PowerShell	✔	✔	✔
TypeScript (Node.js)

Podczas opracowywania funkcji w witrynie Azure Portal należy wziąć pod uwagę następujące ograniczenia:

• Edytowanie w portalu jest obsługiwane tylko w przypadku funkcji utworzonych lub ostatnio zmodyfikowanych w witrynie Azure Portal.
• Edytowanie w portalu jest obsługiwane tylko w przypadku funkcji JavaScript, PowerShell, Python i C# Script.
• Edytowanie w portalu nie jest obecnie obsługiwane przez plan Flex Consumption.
• Podczas wdrażania kodu w aplikacji funkcji spoza witryny Azure Portal nie można już edytować żadnego kodu dla tej aplikacji funkcji w portalu. W tym przypadku po prostu kontynuuj korzystanie z lokalnego programowania.
• W przypadku języka Python programowanie za pomocą modułów niestandardowych nie jest obecnie obsługiwane w portalu. Aby dodać moduły niestandardowe do aplikacji funkcji, należy utworzyć aplikację lokalnie.
• W przypadku skompilowanych funkcji języka C# i funkcji Języka Java można utworzyć aplikację funkcji i powiązane zasoby w portalu. Należy jednak utworzyć projekt kodu funkcji lokalnie, a następnie opublikować go na platformie Azure.

Jeśli to możliwe, opracuj funkcje lokalnie i opublikuj projekt kodu w aplikacji funkcji na platformie Azure. Aby uzyskać więcej informacji, zobacz Kod i testowanie usługi Azure Functions lokalnie.

Ręczne instalowanie rozszerzeń

Funkcje biblioteki klas języka C# mogą zawierać pakiety NuGet dla rozszerzeń powiązań bezpośrednio w projekcie biblioteki klas. W przypadku innych języków non-.NET i skryptu języka C# należy użyć pakietów rozszerzeń. Jeśli musisz ręcznie zainstalować rozszerzenia, możesz to zrobić przy użyciu narzędzi Azure Functions Core Tools lokalnie. Jeśli nie możesz używać pakietów rozszerzeń i nie możesz pracować tylko w portalu, musisz użyć narzędzi zaawansowanych (Kudu), aby ręcznie utworzyć plik extensions.csproj bezpośrednio w witrynie. Najpierw usuń extensionBundle element z pliku host.json .

Ten sam proces działa w przypadku każdego innego pliku, który należy dodać do aplikacji.

Ważne

Jeśli to możliwe, nie edytuj plików bezpośrednio w aplikacji funkcji na platformie Azure. Zalecamy lokalne pobieranie plików aplikacji przy użyciu narzędzi Core Tools do instalowania rozszerzeń i innych pakietów, weryfikowania zmian, a następnie ponownego publikowania aplikacji przy użyciu narzędzi Core Tools lub jednej z innych obsługiwanych metod wdrażania.

Edytor funkcji wbudowany w witrynę Azure Portal umożliwia aktualizowanie kodu funkcji i plików konfiguracji bezpośrednio w portalu:

1. Wybierz aplikację funkcji, a następnie w obszarze Funkcje wybierz pozycję Funkcje.

2. Wybierz funkcję i wybierz pozycję Kod i test w obszarze Deweloper.

3. Wybierz plik do edycji i wybierz pozycję Zapisz po zakończeniu.

Pliki w katalogu głównym aplikacji, takie jak function.proj lub extensions.csproj, muszą zostać utworzone i edytowane przy użyciu narzędzi zaawansowanych (Kudu):

1. Wybierz aplikację funkcji, rozwiń węzeł Narzędzia programistyczne, a następnie wybierz pozycję Narzędzia>zaawansowane Przejdź.

2. Jeśli zostanie wyświetlony monit, zaloguj się do witryny Menedżera kontroli źródła (SCM) przy użyciu poświadczeń platformy Azure.

3. W menu Konsola debugowania wybierz pozycję CMD.

4. Przejdź do .\site\wwwrootpozycji , wybierz przycisk plus (+) u góry, a następnie wybierz pozycję Nowy plik.

5. Nadaj plikowi nazwę, taką jak extensions.csproj, a następnie naciśnij Enter.

6. Wybierz przycisk edytuj obok nowego pliku, dodaj lub zaktualizuj kod w pliku, a następnie wybierz pozycję Zapisz.

7. W przypadku pliku projektu, takiego jak extensions.csproj, uruchom następujące polecenie, aby ponownie skompilować projekt rozszerzeń:

   dotnet build extensions.csproj
   

Funkcje platformy

Aplikacje funkcji działają na platformie usługi aplikacja systemu Azure, która je obsługuje. W związku z tym aplikacje funkcji mają dostęp do większości funkcji podstawowej platformy hostingu internetowego platformy Azure. W przypadku korzystania z witryny Azure Portal lewe okienko to miejsce, w którym uzyskujesz dostęp do wielu funkcji platformy App Service, których można używać w aplikacjach funkcji.

Poniższa macierz wskazuje obsługę funkcji witryny Azure Portal przez plan hostingu i system operacyjny:

Funkcja	Plan Zużycie	Plan Flex Consumption	Plan Premium	Dedykowany plan
Narzędzia zaawansowane (Kudu)	Windows: ✔ Linux: X	X	✔	✔
Edytor usługi App Service	Windows: ✔ Linux: X	X	Windows: ✔ Linux: X	Windows: ✔ Linux: X
Tworzenie kopii zapasowych	X	X	X	✔
Konsola	Windows: wiersz polecenia Linux: X	X	Windows: wiersz polecenia Linux: SSH	Windows: wiersz polecenia Linux: SSH

W pozostałej części tego artykułu skupiono się na następujących funkcjach w portalu, które są przydatne w aplikacjach funkcji:

• Edytor usługi App Service
• Konsola
• Narzędzia zaawansowane (Kudu)
• Opcje wdrożenia
• CORS
• Authentication

Aby uzyskać więcej informacji na temat sposobu pracy z ustawieniami usługi App Service, zobacz Konfigurowanie ustawień usługi aplikacja systemu Azure.

Edytor usługi App Service

Edytor usługi App Service to zaawansowany edytor w portalu, którego można użyć do modyfikowania plików konfiguracji JSON i plików kodu. Wybranie tej opcji powoduje uruchomienie oddzielnej karty przeglądarki z edytorem podstawowym. Ten edytor umożliwia integrację z repozytorium Git, uruchamianie i debugowanie kodu oraz modyfikowanie ustawień aplikacji funkcji. Ten edytor udostępnia ulepszone środowisko programistyczne dla funkcji w porównaniu z wbudowanym edytorem funkcji.

Zalecamy rozważenie opracowywania funkcji na komputerze lokalnym. Podczas tworzenia lokalnego i publikowania na platformie Azure pliki projektu są tylko do odczytu w witrynie Azure Portal. Aby uzyskać więcej informacji, zobacz Kod i testowanie usługi Azure Functions lokalnie.

Konsola

Konsola w portalu to idealne narzędzie deweloperskie, jeśli wolisz korzystać z aplikacji funkcji z poziomu wiersza polecenia. Typowe polecenia obejmują tworzenie katalogów i plików oraz nawigację, a także wykonywanie plików wsadowych i skryptów.

Podczas opracowywania lokalnego zalecamy używanie narzędzi Azure Functions Core Tools i interfejsu wiersza polecenia platformy Azure.

Narzędzia zaawansowane (Kudu)

Zaawansowane narzędzia dla usługi App Service (znanej również jako Kudu) zapewniają dostęp do zaawansowanych funkcji administracyjnych aplikacji funkcji. W usłudze Kudu można zarządzać informacjami systemowymi, ustawieniami aplikacji, zmiennymi środowiskowymi, rozszerzeniami witryny, nagłówkami HTTP i zmiennymi serwera. Możesz również uruchomić narzędzie Kudu , przechodząc do punktu końcowego SCM dla aplikacji funkcji, na przykład: https://<myfunctionapp>.scm.azurewebsites.net/.

Centrum wdrażania

Gdy używasz rozwiązania kontroli źródła do tworzenia i obsługi kodu funkcji, Centrum wdrażania umożliwia kompilowanie i wdrażanie z kontroli źródła. Projekt jest kompilowany i wdrażany na platformie Azure podczas wprowadzania aktualizacji. Aby uzyskać więcej informacji, zobacz Technologie wdrażania w usłudze Azure Functions.

Współużytkowanie zasobów między źródłami

Aby zapobiec złośliwemu wykonywaniu kodu na kliencie, nowoczesne przeglądarki blokują żądania z aplikacji internetowych do zasobów uruchomionych w oddzielnej domenie. Współużytkowanie zasobów między źródłami (CORS) umożliwia Access-Control-Allow-Origin nagłówkowi deklarowanie źródeł, które źródła mogą wywoływać punkty końcowe w aplikacji funkcji.

Witryna Azure Portal

Po skonfigurowaniu listy Dozwolone źródła dla aplikacji Access-Control-Allow-Origin funkcji nagłówek jest automatycznie dodawany do wszystkich odpowiedzi z punktów końcowych HTTP w aplikacji funkcji.

Jeśli istnieje inny wpis domeny, symbol wieloznaczny (*) jest ignorowany.

Interfejs wiersza polecenia platformy Azure

Użyj polecenia , az functionapp cors add aby dodać domenę do listy dozwolonych źródeł. Poniższy przykład dodaje domenę contoso.com:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Użyj polecenia , az functionapp cors show aby wyświetlić listę bieżących dozwolonych źródeł.

Azure PowerShell

Obecnie nie można zaktualizować ustawień mechanizmu CORS przy użyciu programu Azure PowerShell.

Uwierzytelnianie

Gdy funkcje używają wyzwalacza HTTP, można wymagać, aby wywołania najpierw mogły zostać uwierzytelnione. Usługa App Service obsługuje uwierzytelnianie i logowanie firmy Microsoft przy użyciu dostawców społecznościowych, takich jak Facebook, Microsoft i X. Aby uzyskać informacje na temat konfigurowania określonych dostawców uwierzytelniania, zobacz omówienie uwierzytelniania usługi aplikacja systemu Azure.

Powiązana zawartość

• Konfigurowanie aplikacji usługi App Service
• Ciągłe wdrażanie dla usługi Azure Functions