Eseguire la migrazione del servizio mobile di Azure esistente al servizio app di AzureMigrate your existing Azure Mobile Service to Azure App Service

Con la disponibilità generale del servizio app di Azure, è possibile eseguire facilmente la migrazione sul posto dei siti di Servizi mobili di Azure per sfruttare appieno tutte le funzionalità del servizio app di Azure.With the [general availability of Azure App Service], Azure Mobile Services sites can be easily migrated in-place to take advantage of all the features of the Azure App Service. Questo documento illustra cosa accade durante la migrazione del sito da Servizi mobili di Azure al servizio app di Azure.This document explains what to expect when migrating your site from Azure Mobile Services to Azure App Service.

Effetti della migrazione sul sitoWhat does migration do to your site

La migrazione trasforma il servizio mobile di Azure in un'app del servizio app di Azure senza influire sul codice.Migration of your Azure Mobile Service turns your Mobile Service into an [Azure App Service] app without affecting the code. Gli hub di notifica, la connessione dati SQL, le impostazioni di autenticazione, i processi pianificati e il nome di dominio rimangono invariati.Your Notification Hubs, SQL data connection, authentication settings, scheduled jobs, and domain name remain unchanged. I client mobili che usano il servizio mobile di Azure continuano a funzionare normalmente.Mobile clients using your Azure Mobile Service continue to operate normally. Dopo averlo trasferito nel servizio app di Azure, la migrazione riavvia il servizio.Migration restarts your service once it is transferred to Azure App Service.

Sono disponibili due opzioni per il passaggio da Servizi mobili al servizio app: la migrazione o l'aggiornamento.There are two options for moving from Mobile Services to App Service: migration or upgrade. Entrambe le opzioni consentono di accedere a tutte le funzionalità di hosting del servizio app:Either option will give you access to all of the hosting capabilities of App Service:

  • migrazione di un servizio cambia semplicemente l'ambiente sottostante che ospita il back-end mobile.Migrating a service just changes the underlying environment that hosts your mobile backend. Non richiede alcuna modifica del codice per il progetto del client mobile o del server mobile.It requires no code changes to either the mobile client or the mobile server project. Se si usa l'opzione di migrazione automatica, viene mantenuto l'URL service.azure mobile.net .If you use the automated migration option, this preserves your service.azure-mobile.net URL.
  • aggiornamento di un servizio richiede modifiche del codice per il progetto sia del server che del client, ma consente di sfruttare le nuove funzionalità di Mobile SDK, come i miglioramenti dell'autenticazione e la superiore flessibilità per il progetto server.Upgrading a service does require code changes to both your server and client project, but allows you to take advantage of new mobile SDK features, such as improvements to authentication and more flexibility for your server project.

Perché eseguire la migrazione del sitoWhy you should migrate your site

È consigliabile eseguire la migrazione da Servizi mobili di Azure per sfruttare appieno tutte le funzionalità del servizio app di Azure, tra cui:Microsoft is recommending that you migrate your Azure Mobile Service to take advantage of the features of Azure App Service, including:

Per altre informazioni sui vantaggi del servizio app di Azure, vedere Confronto tra Servizi mobili e il servizio app.For more information on the benefits of Azure App Service, see the [Mobile Services vs. App Service] topic.

Prima di iniziareBefore you begin

Prima di iniziare qualsiasi attività importante nel sito, è consigliabile eseguire un backup degli script e del database SQL del servizio mobile.Before beginning any major work on your site, you should back up your Mobile Service scripts and SQL database.

Migrazione dei sitiMigrating your sites

Il processo di migrazione esegue la migrazione di tutti i siti all'interno di una singola area di Azure.The migration process migrates all sites within a single Azure Region.

Per eseguire la migrazione del sito:To migrate your site:

  1. Accedere al portale di Azure classico.Log in to the [Azure Classic Portal].
  2. Selezionare un servizio mobile nell'area di cui si vuole eseguire la migrazione.Select a Mobile Service in the region you wish to migrate.
  3. Fare clic sul pulsante Esegui la migrazione al servizio app.Click the Migrate to App Service button.

    Pulsante di migrazione

  4. Leggere il contenuto della finestra di dialogo Esegui la migrazione al servizio app.Read the Migrate to App Service dialog.
  5. Immettere il nome del servizio mobile nell'apposita casella.Enter the name of your Mobile Service in the box provided. Ad esempio, se il nome di dominio è contoso.azure-mobile.net, immettere contoso nell'apposita casella.For example, if your domain name is contoso.azure-mobile.net, then enter contoso in the box provided.
  6. Fare clic sul pulsante con il segno di spunta.Click the tick button.

Monitorare lo stato della migrazione nel monitoraggio attività.Monitor the status of the migration in the activity monitor. Il sito è indicato come sottoposto a migrazione nel portale di Azure classico.Your site is listed as migrating in the Azure Classic Portal.

Monitoraggio dell'attività di migrazione

Per ogni servizio mobile di cui viene eseguita la migrazione possono essere necessari dai 3 ai 15 minuti.Each migration can take anywhere from 3 to 15 minutes per mobile service being migrated. Durante la migrazione il sito rimane disponibile.Your site remains available during the migration. Al termine del processo di migrazione il sito viene riavviato.Your site is restarted at the end of the migration process. Durante il processo di riavvio il sito non è disponibile per pochi secondi.The site is unavailable during the restart process, which may last a couple of seconds.

Finalizzazione della migrazioneFinalizing the Migration

Pianificare il test del sito da un client mobile al termine del processo di migrazione.Plan to test your site from a mobile client at the conclusion of the migration process. Assicurarsi che sia possibile eseguire tutte le normali azioni client senza apportare modifiche al client mobile.Ensure you can perform all common client actions without changes to the mobile client.

Selezionare un piano tariffario appropriato per il servizio appSelect an appropriate App Service pricing tier

La migrazione al servizio app di Azure offre una maggiore flessibilità dei prezzi.You have more flexibility in pricing after you migrate to Azure App Service.

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Fare clic su Piano di servizio app nel menu Impostazioni.Click App Service Plan in the Settings menu.
  5. Fare clic sul riquadro Piano tariffario.Click the Pricing Tier tile.
  6. Fare clic sul riquadro del piano tariffario più adatto alle proprie esigenze e quindi fare clic su Seleziona.Click the tile appropriate to your requirements, then Click Select. Potrebbe essere necessario fare clic su Visualizza tutto per visualizzare i piani tariffari disponibili.You may need to Click View all to see the available pricing tiers.

Come punto di partenza, è consigliabile scegliere i livelli seguenti:As a starting point, we recommend the following tiers:

Piano tariffario del servizio mobileMobile Service Pricing Tier Piano tariffario del servizio appApp Service Pricing Tier
FreeFree F1 GratuitoF1 Free
BasicBasic B1 BasicB1 Basic
StandardStandard S1 StandardS1 Standard

C'è una notevole flessibilità nella scelta del piano tariffario per l'applicazione.There is considerable flexibility in choosing the right pricing tier for your application. Per informazioni dettagliate sui prezzi del nuovo servizio app, vedere [Prezzi di Servizio app] .Refer to [App Service Pricing] for full details on the pricing of your new App Service.

Suggerimento

Il livello Standard del servizio app include l'accesso a molte funzionalità utili, come ad esempio slot di staging, backup automatico e scalabilità automatica.The App Service Standard tier contains access to many features that you may want to use, including [staging slots], automatic backups, and auto-scaling. Sono anche disponibili nuove funzionalità interessanti.Check out the new capabilities while you are there!

Esaminare i processi dell'utilità di pianificazione di cui è stata eseguita la migrazioneReview the Migrated Scheduler Jobs

I processi dell'utilità di pianificazione non saranno visibili fino a circa 30 minuti dopo la migrazione.Scheduler Jobs will not be visible until approximately 30 minutes after migration. L'esecuzione dei processi pianificati continua in background.Scheduled jobs continue to run in the background. Per visualizzare i processi pianificati quando sono nuovamente visibili, seguire questa procedura:To view your scheduled jobs after they are visible again:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Esplora>, immettere Pianificazione nella casella Filtro e quindi selezionare Raccolte dell'Utilità di pianificazione.Select Browse>, enter Schedule in the Filter box, then select Scheduler Collections.

Dopo la migrazione è disponibile un numero limitato di processi dell'utilità di pianificazione gratuiti.There are a limited number of free scheduler jobs available post-migration. Esaminare l'utilizzo e i piani dell'utilità di pianificazione di Azure.Review your usage and the [Azure Scheduler Plans].

Configurare la condivisione CORS se necessarioConfigure CORS if needed

La condivisione di risorse tra le origini è una tecnica che consente a un sito Web di accedere a un'API Web in un dominio diverso.Cross-origin resource sharing is a technique to allow a website to access a Web API on a different domain. Se si usa Servizi mobili di Azure con un sito Web associato è necessario configurare la condivisione CORS come parte della migrazione.If you are using Azure Mobile Services with an associated website, then you need to configure CORS as part of the migration. Se l'accesso a Servizi mobili di Azure avviene esclusivamente da dispositivi mobili, non è necessario configurare la condivisione CORS se non in alcuni casi specifici.If you are accessing Azure Mobile Services exclusively from mobile devices, then CORS does not need to be configured except in rare cases.

Le impostazioni CORS di cui è stata eseguita la migrazione sono disponibili come impostazione app MS_CrossDomainWhitelist.Your migrated CORS settings are available as the MS_CrossDomainWhitelist App Setting. Per eseguire la migrazione del sito alla funzionalità CORS del servizio app:To migrate your site to the App Service CORS facility:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Fare clic su CORS nel menu dell'API.Click CORS in the API menu.
  5. Immettere tutte le origini consentite nell'apposita casella, premendo INVIO dopo ogni immissione.Enter any Allowed Origins in the box provided, pressing Enter after each one.
  6. Dopo aver compilato correttamente l'elenco di origini consentite, fare clic sul pulsante Salva.Once your list of Allowed Origins is correct, click the Save button.

Suggerimento

Uno dei vantaggi dell'uso di un servizio app di Azure è che è possibile eseguire il sito Web e il servizio mobile nello stesso sito.One of the advantages of using an Azure App Service is that you can run your web site and mobile service on the same site. Per altre informazioni, vedere la sezione Passaggi successivi.For more information, see the next steps section.

Scaricare un nuovo profilo di pubblicazioneDownload a new Publishing Profile

Il profilo di pubblicazione del sito viene modificato durante la migrazione al Servizio app di Azure.The publishing profile of your site is changed when migrating to Azure App Service. Se si intende pubblicare il sito da Visual Studio, è necessario un nuovo profilo di pubblicazione.If you intend to publish your site from within Visual Studio, you need a new publishing profile. Per scaricare il nuovo profilo di pubblicazione:To download the new publishing profile:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Fare clic su Recupera profilo di pubblicazione.Click Get publish profile.

Il file PublishSettings verrà scaricato nel computer.The PublishSettings file is downloaded to your computer. In genere è denominato nomesito.PublishSettings.It is normally called sitename.PublishSettings. Importare le impostazioni di pubblicazione nel progetto esistente:Import the publish settings into your existing project:

  1. Aprire Visual Studio e il progetto di Servizi mobili di Azure.Open Visual Studio and your Azure Mobile Service project.
  2. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Pubblica.Right-Click your project in the Solution Explorer and select Publish...
  3. Fare clic su Importa.Click Import
  4. Fare clic su Sfoglia e selezionare il file delle impostazioni di pubblicazione scaricato.Click Browse and select your downloaded publish settings file. Fare clic su OK.Click OK
  5. Fare clic su Convalida connessione per verificare il corretto funzionamento delle impostazioni di pubblicazione.Click Validate Connection to ensure the publish settings work.
  6. Fare clic su Pubblica per pubblicare il sito.Click Publish to publish your site.

Uso del sito dopo la migrazioneWorking with your site post-migration

Dopo la migrazione è possibile iniziare a usare il nuovo servizio app nel portale di Azure.Start working with your new App Service in the [Azure portal] post-migration. Di seguito sono riportate informazioni sulle operazioni specifiche che era possibile eseguire nel portale di Azure classico, con i rispettivi equivalenti nel servizio app.The following are some notes on specific operations that you used to perform in the [Azure Classic Portal], together with their App Service equivalent.

Download e pubblicazione del sito di cui è stata eseguita la migrazioneDownloading and Publishing your migrated site

Il sito è disponibile tramite Git o FTP e può essere pubblicato nuovamente con vari meccanismi, inclusi WebDeploy, TFS, Mercurial, GitHub e FTP.Your site is available via git or ftp and can be republished with various different mechanisms, including WebDeploy, TFS, Mercurial, GitHub, and FTP. La migrazione delle credenziali di distribuzione viene eseguita con il resto del sito.The deployment credentials are migrated with the rest of your site. Se le credenziali di distribuzione non sono state impostate o non sono disponibili, è possibile reimpostarle:If you did not set your deployment credentials or you do not remember them, you can reset them:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Fare clic su Credenziali di distribuzione nel menu PUBBLICAZIONE.Click Deployment credentials in the PUBLISHING menu.
  5. Immettere le nuove credenziali di distribuzione nelle apposite caselle e quindi fare clic sul pulsante Salva.Enter the new deployment credentials in the boxes provided, then click the Save button.

È possibile usare queste credenziali per clonare il sito con Git o configurare distribuzioni automatizzate da GitHub, TFS o Mercurial.You can use these credentials to clone the site with git or set up automated deployments from GitHub, TFS, or Mercurial. Per altre informazioni, vedere la [documentazione sulla distribuzione del Servizio app di Azure].For more information, see the [Azure App Service deployment documentation].

Impostazioni dell'applicazioneApplication Settings

La maggior parte delle impostazioni di un servizio mobile di cui è stata eseguita la migrazione è disponibile in Impostazioni app.Most settings for a migrated mobile service are available via App Settings. Nel portale di Azure è possibile ottenere un elenco delle impostazioni dell'app.You can get a list of the app settings from the [Azure portal]. Per visualizzare o modificare le impostazioni app:To view or change your app settings:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Fare clic su Impostazioni dell'applicazione nel menu GENERALE.Click Application settings in the GENERAL menu.
  5. Scorrere fino alla sezione Impostazioni app e trovare l'impostazione dell'app.Scroll to the App Settings section and find your app setting.
  6. Fare clic sul valore dell'impostazione app per modificarlo.Click the value of the app setting to edit the value. Fare clic su Salva per salvare il valore.Click Save to save the value.

È possibile aggiornare le impostazioni di più app contemporaneamente.You can update multiple app settings at the same time.

Suggerimento

Sono disponibili due impostazioni dell'applicazione con lo stesso valore.There are two Application Settings with the same value. Ad esempio, ApplicationKey e MS_ApplicationKey.For example, you may see ApplicationKey and MS_ApplicationKey. Aggiornare entrambe le impostazioni dell'applicazione contemporaneamente.Update both application settings at the same time.

AutenticazioneAuthentication

Tutte le impostazioni di autenticazione sono disponibili come impostazioni app nel sito di cui è stata eseguita la migrazione.All authentication settings are available as App Settings in your migrated site. Per aggiornare le impostazioni di autenticazione, è necessario modificare le impostazioni app appropriate.To update your authentication settings, you must alter the appropriate app settings. La tabella seguente riporta le impostazioni app appropriate per il provider di autenticazione:The following table shows the appropriate app settings for your authentication provider:

ProviderProvider ID clientClient ID Client SecretClient Secret Altre impostazioniOther Settings
Account MicrosoftMicrosoft Account MS_MicrosoftClientIDMS_MicrosoftClientID MS_MicrosoftClientSecretMS_MicrosoftClientSecret MS_MicrosoftPackageSIDMS_MicrosoftPackageSID
FacebookFacebook MS_FacebookAppIDMS_FacebookAppID MS_FacebookAppSecretMS_FacebookAppSecret
TwitterTwitter MS_TwitterConsumerKeyMS_TwitterConsumerKey MS_TwitterConsumerSecretMS_TwitterConsumerSecret
GoogleGoogle MS_GoogleClientIDMS_GoogleClientID MS_GoogleClientSecretMS_GoogleClientSecret
Azure ADAzure AD MS_AadClientIDMS_AadClientID MS_AadTenantsMS_AadTenants

Nota: l'impostazione MS_AadTenants viene archiviata come elenco delimitato da virgole dei domini del tenant, corrispondente al campo "Tenant consentiti" del portale di Servizi mobili.Note: MS_AadTenants is stored as a comma-separated list of tenant domains (the "Allowed Tenants" fields in the Mobile Services portal).

Avviso

Non usare i meccanismi di autenticazione nel menu ImpostazioniDo not use the authentication mechanisms in the Settings menu

Il servizio app di Azure fornisce un sistema di autenticazione e autorizzazione senza codice a parte nel menu Impostazioni di Autenticazione/Autorizzazione e l'opzione Autenticazione per dispositivi mobili (deprecata) nel menu Impostazioni.Azure App Service provides a separate "no-code" Authentication and Authorization system under the Authentication / Authorization Settings menu and the (deprecated) Mobile Authentication option under the Settings menu. Queste opzioni non sono compatibili con un servizio mobile di Azure di cui è stata eseguita la migrazione.These options are incompatible with a migrated Azure Mobile Service. È possibile aggiornare il sito per sfruttare i vantaggi dell'autenticazione del servizio app di Azure.You can upgrade your site to take advantage of the Azure App Service authentication.

DatiData

La scheda Dati in Servizi mobili è stata sostituita da Tabelle semplici nel portale di Azure.The Data tab in Mobile Services has been replaced by Easy Tables within the Azure portal. Per accedere a Easy Tables:To access Easy Tables:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Fare clic su Tabelle semplici nel menu MOBILE.Click Easy tables in the MOBILE menu.

È possibile aggiungere una tabella facendo clic sul pulsante Aggiungi o accedere alle tabelle esistenti facendo clic sul nome della tabella.You can add a table by clicking the Add button or access your existing tables by clicking a table name. Da questo pannello è possibile eseguire una serie di operazioni, tra cui:There are various operations you can do from this blade, including:

  • Modifica delle autorizzazioni tabellaChanging table permissions
  • Modifica degli script operativiEditing the operational scripts
  • Gestione dello schema di tabellaManaging the table schema
  • Eliminazione della tabellaDeleting the table
  • Cancellazione del contenuto della tabellaClearing the table contents
  • Eliminazione di righe specifiche della tabellaDeleting specific rows of the table

APIAPI

La scheda API in Servizi mobili è stata sostituita da API semplici nel portale di Azure.The API tab in Mobile Services has been replaced by Easy APIs within the Azure portal. Per accedere a Easy APIs:To access Easy APIs:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Fare clic su API semplici nel menu MOBILE.Click Easy APIs in the MOBILE menu.

Le API di cui è stata eseguita la migrazione sono già elencate nel pannello.Your migrated APIs are already listed in the blade. Dal pannello è anche possibile aggiungere un'API.You can also add an API from this blade. Per gestire un'API specifica, fare clic su di essa.To manage a specific API, click the API. Dal nuovo pannello è possibile modificare le autorizzazioni e gli script per l'API.From the new blade, you can adjust the permissions and edit the scripts for the API.

Processi dell'Utilità di pianificazioneScheduler Jobs

Tutti i processi dell'Utilità di pianificazione sono disponibili tramite la sezione relativa alle raccolte dei processi dell'Utilità di pianificazione.All scheduler jobs are available through the Scheduler Job Collections section. Per accedere ai processi dell'Utilità di pianificazione:To access your scheduler jobs:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Esplora>, immettere Pianificazione nella casella Filtro e quindi selezionare Raccolte dell'Utilità di pianificazione.Select Browse>, enter Schedule in the Filter box, then select Scheduler Collections.
  3. Selezionare la raccolta di processi per il sito.Select the Job Collection for your site. È denominata nomesito-Processi.It is named sitename-Jobs.
  4. Fare clic su Impostazioni.Click Settings.
  5. Fare clic su Processi dell'Utilità di pianificazione in GESTISCI.Click Scheduler Jobs under MANAGE.

I processi pianificati vengono elencati con la frequenza specificata prima della migrazione.Scheduled jobs are listed with the frequency you specified before migration. I processi su richiesta sono disabilitati.On-demand jobs are disabled. Per eseguire un processo su richiesta:To run an on-demand job:

  1. Selezionare il processo che si desidera eseguire.Select the job you wish to run.
  2. Se necessario, fare clic su Abilita per abilitare il processo.If necessary, click Enable to enable the job.
  3. Fare clic su Impostazioni e quindi su Pianificazione.Click Settings, then Schedule.
  4. Selezionare la ricorrenza Una sola volta e quindi fare clic su Salva.Select a Recurrence of Once, then Click Save

I processi su richiesta si trovano in App_Data/config/scripts/scheduler post-migration.Your on-demand jobs are located in App_Data/config/scripts/scheduler post-migration. È consigliabile convertire tutti i processi su richiesta in [processi Web] o in funzioni.We recommend that you convert all on-demand jobs to [WebJobs] or [Functions]. Scrivere i nuovi processi dell'Utilità di pianificazione come [processi Web] o funzioni.Write new scheduler jobs as [WebJobs] or [Functions].

Hub di notificaNotification Hubs

Servizi mobili usa Hub di notifica per le notifiche push.Mobile Services uses Notification Hubs for push notifications. Le impostazioni app riportate di seguito vengono usate per collegare l'hub di notifica al servizio mobile dopo la migrazione:The following App Settings are used to link the Notification Hub to your Mobile Service after migration:

Impostazione dell'applicazioneApplication Setting DescrizioneDescription
MS_PushEntityNamespaceMS_PushEntityNamespace Spazio dei nomi dell'hub di notificaThe Notification Hub Namespace
MS_NotificationHubNameMS_NotificationHubName Nome dell'hub di notificaThe Notification Hub Name
MS_NotificationHubConnectionStringMS_NotificationHubConnectionString Stringa di connessione dell'hub di notificaThe Notification Hub Connection String
MS_NamespaceNameMS_NamespaceName Alias per MS_PushEntityNamespaceAn alias for MS_PushEntityNamespace

L'hub di notifica viene gestito attraverso il portale di Azure.Your Notification Hub is managed through the [Azure portal]. Prendere nota del nome dell'hub di notifica. Per trovarlo è possibile usare le impostazioni app:Note the Notification Hub name (you can find this using the App Settings):

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Esplora> e quindi Hub di notifica.Select Browse>, then select Notification Hubs
  3. Fare clic sul nome dell'hub di notifica associato al servizio mobile.Click the Notification Hub name associated with the mobile service.

Nota

Se l'hub di notifica è di tipo "Misto", non è visibile.If your Notification HUb is a "Mixed" type, it is not visible. Gli hub di notifica di tipo "Misto" utilizzano sia Hub di notifica che le funzionalità legacy del bus di servizio."Mixed" type notification hubs utilize both Notification Hubs and legacy Service Bus features. Convertire gli spazi dei nomi di tipo Misto prima di continuare.[Convert your Mixed namespaces] before continuing. Al termine della conversione, l'hub di notifica viene visualizzato nel portale di Azure.Once the conversion is complete, your notification hub appears in the [Azure portal].

Per altre informazioni, vedere la documentazione relativa a Hub di notifica .For more information, review the [Notification Hubs] documentation.

Suggerimento

Le funzionalità di gestione di Hub di notifica nel portale di Azure sono ancora in anteprima.Notification Hubs management features in the [Azure portal] are still in preview. Il portale di Azure classico rimane disponibile per la gestione di tutti gli hub di notifica.The [Azure Classic Portal] remains available for managing all your Notification Hubs.

Impostazioni push legacyLegacy Push Settings

Se è stato configurato il push nel servizio mobile prima dell'introduzione di Hub di notifica, si sta usando la funzione push legacy.If you configured Push on your mobile service before the introduction on Notification Hubs, you are using legacy push. Se si usa il push e nella configurazione non è presente un hub di notifica, è probabile che si stia usando la funzione push legacy.If you are using Push and you do not see a Notification Hub listed in your configuration, then it is likely you are using legacy push. La migrazione di questa funzionalità viene eseguita insieme a tutte le altre.This feature is migrated with all the other features. È tuttavia consigliabile eseguire l'aggiornamento a Hub di notifica subito dopo il completamento della migrazione.However, we recommend that you upgrade to Notification Hubs soon after the migration is complete.

Nel frattempo tutte le impostazioni push legacy, con l'importante eccezione del certificato del servizio APN, sono disponibili in Impostazioni app.In the interim, all the legacy push settings (with the notable exception of the APNS certificate) are available in App Settings. Aggiornare il certificato del servizio APN sostituendo il file appropriato nel file system.Update the APNS certificate by replacing the appropriate file on the filesystem.

Altre impostazioni appOther App Settings

Per le impostazioni app aggiuntive riportate di seguito viene eseguita la migrazione dal servizio mobile e sono disponibili in Impostazioni > App Impostazioni:The following additional app settings are migrated from your Mobile Service and available under Settings > App Settings:

Impostazione dell'applicazioneApplication Setting DescrizioneDescription
MS_MobileServiceNameMS_MobileServiceName Nome dell'appThe name of your app
MS_MobileServiceDomainSuffixMS_MobileServiceDomainSuffix Prefisso del dominio,The domain prefix. vale a direi.e azure-mobile.netazure-mobile.net
MS_ApplicationKeyMS_ApplicationKey Chiave applicazioneYour application key
MS_MasterKeyMS_MasterKey Chiave master dell'appYour app master key

La chiave applicazione e la chiave master sono identiche alle chiavi applicazione del servizio mobile di origine.The application key and master key are identical to the Application Keys from your original Mobile Service. In particolare, la chiave applicazione viene inviata dai client mobili per convalidare l'uso dell'API per dispositivi mobili.In particular, the Application Key is sent by mobile clients to validate their use of the mobile API.

Equivalenti della riga di comandoCommand-Line Equivalents

Non è più possibile usare il comando azure mobile per gestire il sito di Servizi mobili di Azure.You can longer use the azure mobile command to manage your Azure Mobile Services site. Molte funzioni sono state sostituite con il comando azure site.Instead, many functions have been replaced with the azure site command. Usare la tabella seguente per trovare gli equivalenti dei comandi più comuni:Use the following table to find equivalents for common commands:

Comando azure mobileAzure Mobile Command Comando azure site equivalenteEquivalent Azure Site command
mobile locationsmobile locations site location listsite location list
mobile listmobile list site listsite list
mobile show nomemobile show name site show nomesite show name
mobile restart nomemobile restart name site restart nomesite restart name
mobile redeploy nomemobile redeploy name site deployment redeploy commitId nomesite deployment redeploy commitId name
mobile key set nome tipo valoremobile key set name type value site appsetting delete chiave nomesite appsetting delete key name
site appsetting add chiave=valore nomesite appsetting add key=value name
mobile config list nomemobile config list name site appsetting list nomesite appsetting list name
mobile config get nome chiavemobile config get name key site appsetting show chiave nomesite appsetting show key name
mobile config set nome chiavemobile config set name key site appsetting delete chiave nomesite appsetting delete key name
site appsetting add chiave=valore nomesite appsetting add key=value name
mobile domain list nomemobile domain list name site domain list nomesite domain list name
mobile dominio add nome dominiomobile domain add name domain site domain add dominio nomesite domain add domain name
mobile domain delete nomemobile domain delete name site domain delete dominio nomesite domain delete domain name
mobile scale show nomemobile scale show name site show nomesite show name
mobile scale change nomemobile scale change name site scale mode modalità nomesite scale mode mode name
site scale instances istanze nomesite scale instances instances name
mobile appsetting list nomemobile appsetting list name site appsetting list nomesite appsetting list name
mobile appsetting add nome chiave valoremobile appsetting add name key value site appsetting add chiave=valore nomesite appsetting add key=value name
mobile appsetting delete nome chiavemobile appsetting delete name key site appsetting delete chiave nomesite appsetting delete key name
mobile appsetting show nome chiavemobile appsetting show name key site appsetting delete chiave nomesite appsetting delete key name

Aggiornare le impostazioni di autenticazione o di notifica push aggiornando l'impostazione dell'applicazione appropriata.Update authentication or push notification settings by updating the appropriate Application Setting. Modificare i file e pubblicare il sito tramite Git o FTP.Edit files and publish your site via ftp or git.

Diagnostica e registrazioneDiagnostics and Logging

Nel servizio app di Azure la registrazione diagnostica è generalmente disabilitata.Diagnostic Logging is normally disabled in an Azure App Service. Per abilitare la registrazione diagnostica:To enable diagnostic logging:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Per impostazione predefinita si apre il pannello Impostazioni.The Settings blade opens by default.
  4. Selezionare Log di diagnostica nel menu FUNZIONALITÀ.Select Diagnostic Logs under the FEATURES menu.
  5. Fare clic su per i log seguenti: Registrazione applicazioni (file system), Messaggi di errore dettagliati e Traccia delle richieste non riuscite.Click ON for the following logs: Application Logging (Filesystem), Detailed error messages, and Failed request tracing
  6. Fare clic su File System per la registrazione del server Web.Click File System for Web server logging
  7. Fare clic su SaveClick Save

Per visualizzare i log:To view the logs:

  1. Accedere al portale di Azure.Log in to the [Azure portal].
  2. Selezionare Tutte le risorse o Servizi app e quindi fare clic sul nome del servizio mobile di cui è stata eseguita la migrazione.Select All resources or App Services then click the name of your migrated Mobile Service.
  3. Fare clic sul pulsante Strumenti.Click the Tools button
  4. Selezionare Flusso di registrazione nel menu OSSERVAZIONE.Select Log Stream under the OBSERVE menu.

I log vengono visualizzati nella finestra man mano che vengono generati.Logs are displayed in the window as they are generated. È anche possibile scaricare i log per analizzarli in seguito usando le credenziali di distribuzione.You can also download the logs for later analysis using your deployment credentials. Per altre informazioni, vedere la documentazione relativa alla registrazione.For more information, see the [Logging] documentation.

Problemi notiKnown Issues

L'eliminazione del clone di un'app per dispositivi mobili di cui è stata eseguita la migrazione provoca un'interruzione del sitoDeleting a Migrated Mobile App Clone causes a site outage

Se si clona il servizio mobile di cui è stata eseguita la migrazione usando Azure PowerShell e si elimina il clone, viene rimossa la voce DNS per il servizio di produzione.If you clone your migrated mobile service using Azure PowerShell, then delete the clone, the DNS entry for your production service is removed. Quindi, il sito non è più accessibile da Internet.Your site is no longer be accessible from the Internet.

Risoluzione: se si vuole clonare il sito, effettuare questa operazione tramite il portale.Resolution: If you wish to clone your site, do so through the portal.

Le modifiche a Web.config non funzionanoChanging Web.config does not work

Se si usa un sito ASP.NET, le modifiche al file Web.config non vengono applicate.If you have an ASP.NET site, changes to the Web.config file do not get applied. Il servizio app di Azure compila un file Web.config appropriato durante l'avvio per supportare il runtime di Servizi mobili.The Azure App Service builds a suitable Web.config file during startup to support the Mobile Services runtime. È possibile eseguire l'override di alcune impostazioni, ad esempio le intestazioni personalizzate, tramite un file di trasformazione XML.You can override certain settings (such as custom headers) by using an XML transform file. Creare un file denominato applicationHost.xdt. Questo file deve essere salvato nella directory D:\home\site del servizio di Azure.Create a file in called applicationHost.xdt - this file must end up in the D:\home\site directory on the Azure Service. Caricare il file applicationHost.xdt tramite uno script di distribuzione personalizzato o direttamente tramite Kudu.Upload the applicationHost.xdt file via a custom deployment script or directly using Kudu. Di seguito viene illustrato un esempio di documento:The following shows an example document:

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <system.webServer>
    <httpProtocol>
      <customHeaders>
        <add name="X-Frame-Options" value="DENY" xdt:Transform="Replace" />
        <remove name="X-Powered-By" xdt:Transform="Insert" />
      </customHeaders>
    </httpProtocol>
    <security>
      <requestFiltering removeServerHeader="true" xdt:Transform="SetAttributes(removeServerHeader)" />
    </security>
  </system.webServer>
</configuration>

Per altre informazioni, vedere la documentazione XDT transform samples in GitHub.For more information, see the XDT Transform Samples documentation on GitHub.

Non è possibile aggiungere a Gestione traffico servizi mobili di cui è stata eseguita la migrazioneMigrated Mobile Services cannot be added to Traffic Manager

Quando si crea un profilo di Gestione traffico, non è possibile scegliere direttamente un servizio mobile di cui è stata eseguita la migrazione al profilo.When you create a Traffic Manager profile, you cannot directly choose a migrated mobile service to the profile. È necessario usare un "endpoint esterno".Use an "external endpoint." L'endpoint esterno può essere aggiunto solo tramite PowerShell.The external endpoint can only be added through PowerShell. Per altre informazioni, vedere l'esercitazione su Gestione traffico.For more information, see the Traffic Manager tutorial.

Passaggi successiviNext Steps

Dopo aver eseguito la migrazione dell'applicazione nel servizio app, è possibile sfruttare ancora più funzionalità:Now that your application is migrated to App Service, there are even more features you can use:

  • Gli slot di staging della distribuzione consentono lo staging delle modifiche al sito e di eseguire un test A/B.Deployment [staging slots] allow you to stage changes to your site and perform A/B testing.
  • [Processi Web] consente di sostituire i processi pianificati su richiesta.[WebJobs] provide a replacement for On-demand scheduled jobs.
  • La distribuzione continua del sito è resa possibile collegando il sito a GitHub, TFS o Mercurial.You can [continuously deploy] your site by linking your site to GitHub, TFS, or Mercurial.
  • È possibile usare Application Insights per monitorare il sito.You can use Application Insights to monitor your site.
  • È possibile gestire un sito Web e un'API per dispositivi mobili dallo stesso codice.Serve a website and a Mobile API from the same code.

Aggiornamento del sito di Servizi mobili ad Azure Mobile App SDKUpgrading your Mobile Services site to Azure Mobile Apps SDK

  • Per i progetti server basati su Node.js, il nuovo Mobile Apps Node.js SDK offre diverse nuove funzionalità.For Node.js-based server projects, the new Mobile Apps Node.js SDK provides several new features. Ad esempio, è possibile ora eseguire sviluppi e debug locali, utilizzare qualsiasi versione Node.js successiva alla 0.10 e personalizzare con qualsiasi middleware Express.js.For instance, you can now do local development and debugging, use any Node.js version above 0.10, and customize with any Express.js middleware.
  • Per i progetti server basati su .NET, i nuovi pacchetti NuGet Mobile Apps SDK offrono una maggiore flessibilità sulle dipendenze NuGet.For .NET-based server projects, the new Mobile Apps SDK NuGet packages have more flexibility on NuGet dependencies. Questi pacchetti supportano la nuova autenticazione del servizio app e sono compatibili con qualsiasi progetto ASP.NET.These packages support the new App Service authentication, and compose with any ASP.NET project. Per altre informazioni sull'aggiornamento, vedere Aggiornamento del servizio mobile .NET di Azure esistente al Servizio app.To learn more about upgrading, see Upgrade your existing .NET Mobile Service to App Service.