ASP.NET implementación web mediante Visual Studio: Preparación de la implementación de bases de datos

Descargar proyecto de inicio

En esta serie de tutoriales se muestra cómo implementar (publicar) una aplicación web de ASP.NET en Azure App Service Web Apps o en un proveedor de hospedaje de terceros mediante Visual Studio 2012 o Visual Studio 2010. Para obtener información sobre la serie, consulte el primer tutorial de la serie.

Visión general

En este tutorial se muestra cómo preparar el proyecto para la implementación de la base de datos. La estructura de la base de datos y algunos datos (no todos) de las dos bases de datos de la aplicación deben implementarse para los entornos de prueba, preproducción y producción.

Normalmente, a medida que desarrollas una aplicación, introduces datos de prueba en una base de datos que no deseas desplegar en un sitio activo. Sin embargo, es posible que también tenga algunos datos de producción que quiera implementar. En este tutorial configurará el proyecto Contoso University y preparará scripts SQL para que se incluyan los datos correctos al implementar.

Aviso: Si recibe un mensaje de error o algo no funciona mientras recorre el tutorial, asegúrese de comprobar la página de solución de problemas.

SQL Server Express LocalDB (base de datos local)

La aplicación de ejemplo usa SQL Server Express LocalDB. SQL Server Express es la edición gratuita de SQL Server. Normalmente se usa durante el desarrollo porque se basa en el mismo motor de base de datos que las versiones completas de SQL Server. Puede probar con SQL Server Express y asegurarse de que la aplicación se comportará igual en producción, con algunas excepciones para las características que varían entre ediciones de SQL Server.

LocalDB es un modo de ejecución especial de SQL Server Express que permite trabajar con bases de datos como archivos .mdf . Normalmente, los archivos de base de datos LocalDB se conservan en la carpeta App_Data de un proyecto web. La característica de instancia de usuario de SQL Server Express también le permite trabajar con archivos .mdf, pero la característica de instancia de usuario está en desuso; por tanto, se recomienda LocalDB para trabajar con archivos .mdf.

Normalmente, SQL Server Express no se usa para aplicaciones web en producción. LocalDB en particular no se recomienda para su uso en producción con una aplicación web porque no está diseñado para trabajar con IIS.

En Visual Studio 2012, LocalDB se instala de forma predeterminada con Visual Studio. En Visual Studio 2010 y versiones anteriores, SQL Server Express (sin LocalDB) se instala de forma predeterminada con Visual Studio; es por eso que lo instaló como uno de los requisitos previos del primer tutorial de esta serie.

Para obtener más información sobre las ediciones de SQL Server, incluida LocalDB, consulte los siguientes recursos Trabajando con bases de datos de SQL Server.

Entity Framework y proveedores universales

Para el acceso a la base de datos, la aplicación Contoso University requiere el siguiente software que se debe implementar con la aplicación porque no se incluye en .NET Framework:

• ASP.NET Proveedores Universales (permite que el sistema de membresía de ASP.NET use Azure SQL Database)
• Entity Framework

Dado que este software se incluye en paquetes NuGet, el proyecto ya está configurado para que los ensamblados necesarios se implementen con el proyecto. (Los vínculos apuntan a las versiones actuales de estos paquetes, que podrían ser más recientes que lo que está instalado en el proyecto de inicio que descargó para este tutorial).

Si va a implementar en un proveedor de hospedaje de terceros en lugar de Azure, asegúrese de usar Entity Framework 5.0 o posterior. Las versiones anteriores de migraciones de Code First requieren plena confianza y la mayoría de los proveedores de hospedaje ejecutarán la aplicación en confianza media. Para obtener más información sobre la confianza media, consulte el tutorial Implementación en IIS como entorno de prueba .

Configuración de migraciones de Code First para la implementación de bases de datos de aplicaciones

Code First administra la base de datos de aplicaciones de Contoso University y la implementará mediante migraciones de Code First. Para obtener información general sobre la implementación de bases de datos mediante migraciones de Code First, consulte el primer tutorial de esta serie.

Al implementar una base de datos de aplicación, normalmente no solo se implementa la base de datos de desarrollo con todos los datos de ella en producción, ya que gran parte de los datos de ella probablemente solo están allí con fines de prueba. Por ejemplo, los nombres de los alumnos de una base de datos de prueba son ficticios. Por otro lado, a menudo no se puede implementar solo la estructura de la base de datos sin datos en ella. Algunos de los datos de la base de datos de prueba pueden ser datos reales y deben estar allí cuando los usuarios empiecen a usar la aplicación. Por ejemplo, la base de datos puede tener una tabla que contenga valores de grado válidos o nombres de departamento reales.

Para simular este escenario común, configurará un método de migraciones Seed de Code First que inserta en la base de datos solo los datos que desea que estén en producción. Este Seed método no debe insertar datos de prueba porque se ejecutará en producción después de que Code First cree la base de datos en producción.

En versiones anteriores de Code First antes de que se publicara Migraciones, era habitual que Seed los métodos inserte también datos de prueba, ya que, con cada cambio de modelo durante el desarrollo, la base de datos tenía que eliminarse y volver a crearse desde cero. Con las migraciones de Code First, los datos de prueba se conservan después de los cambios en la base de datos, por lo que no es necesario incluir datos de prueba en el Seed método. El proyecto que descargó usa el método de incluir todos los datos en el Seed método de una clase de inicializador. En este tutorial, deshabilitará esa clase de inicializador y habilitará Migraciones. A continuación, actualizará el método Seed en la clase de configuración de Migraciones para que inserte solo los datos que desea insertar en producción.

En el diagrama siguiente se muestra el esquema de la base de datos de aplicación:

En estos tutoriales, se supone que las Student tablas y Enrollment deben estar vacías cuando el sitio se implemente por primera vez. Las demás tablas contienen datos que tienen que cargarse previamente cuando la aplicación pasa a estar activa.

Deshabilitar el inicializador

Dado que va a usar migraciones de Code First, no tiene que usar el DropCreateDatabaseIfModelChanges inicializador Code First. El código de este inicializador se encuentra en el archivo SchoolInitializer.cs del proyecto ContosoUniversity.DAL. Un valor en el appSettings elemento del archivo Web.config hace que este inicializador se ejecute siempre que la aplicación intente acceder a la base de datos por primera vez:

<appSettings>
  <add key="Environment" value="Dev" />
  <add key="DatabaseInitializerForType ContosoUniversity.DAL.SchoolContext, ContosoUniversity.DAL" value="ContosoUniversity.DAL.SchoolInitializer, ContosoUniversity.DAL" />
</appSettings>

Abra el archivo Web.config de la aplicación y quite o comente la etiqueta add que especifica la clase de inicializador Code First. El appSettings elemento ahora tiene el siguiente aspecto:

<appSettings>
  <add key="Environment" value="Dev" />
</appSettings>

Habilitación de migraciones de Code First

1. Asegúrese de que el proyecto ContosoUniversity (no ContosoUniversity.DAL) esté establecido como proyecto de inicio. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto ContosoUniversity y seleccione Establecer como proyecto de inicio. Las migraciones de Code First buscarán en el proyecto de inicio para encontrar la cadena de conexión de la base de datos.

2. En el menú Herramientas, elija Administrador de Paquetes NuGet>Consola del Administrador de Paquetes.

   

3. En la parte superior de la ventana Consola del Administrador de paquetes, seleccione ContosoUniversity.DAL como proyecto predeterminado y, a continuación, en el símbolo del PM> sistema, escriba "enable-migrations".

   

   (Si recibe un error que indica que no se reconoce el comando enable-migrations , escriba el comando update-package EntityFramework -Reinstalar e inténtelo de nuevo).

   Este comando crea una carpeta Migrations en el proyecto ContosoUniversity.DAL y coloca en esa carpeta dos archivos: un archivo Configuration.cs que puede usar para configurar migraciones y un archivo InitialCreate.cs para la primera migración que crea la base de datos.

   

   Ha seleccionado el proyecto DAL en la lista desplegable Proyecto predeterminado de la consola del Administrador de paquetes porque el enable-migrations comando debe ejecutarse en el proyecto que contiene la clase de contexto Code First. Cuando esa clase se encuentra en un proyecto de biblioteca de clases, Code First Migrations busca la cadena de conexión de base de datos en el proyecto de inicio de la solución. En la solución ContosoUniversity, el proyecto web se ha establecido como proyecto de inicio. Si no desea designar el proyecto que tiene la cadena de conexión como proyecto de inicio en Visual Studio, puede especificar el proyecto de inicio en el comando de PowerShell. Para ver la sintaxis del comando, escriba el comando get-help enable-migrations.

   El enable-migrations comando creó automáticamente la primera migración porque la base de datos ya existe. Una alternativa es hacer que Migrations cree la base de datos. Para ello, use el Explorador de servidores o el Explorador de objetos de SQL Server para eliminar la base de datos ContosoUniversity antes de habilitar migraciones. Después de habilitar las migraciones, cree la primera migración manualmente escribiendo el comando "add-migration InitialCreate". Después, puede crear la base de datos escribiendo el comando "update-database".

Configuración del método Seed

Para este tutorial, agregará datos fijos agregando código al Seed método de la clase Code First Migrations Configuration . Code First Migrations llama al método Seed después de cada migración.

Dado que el Seed método se ejecuta después de cada migración, ya hay datos en las tablas después de la primera migración. Para controlar esta situación, usará el AddOrUpdate método para actualizar las filas que ya se han insertado o insertarlas si aún no existen. Es posible que el AddOrUpdate método no sea la mejor opción para su escenario. Para obtener más información, consulte El método AddOrUpdate de EF 4.3 en el blog de Julie Lerman.

1. Abra el archivo Configuration.cs y reemplace los comentarios del Seed método por el código siguiente:

   var instructors = new List<Instructor>
   {   
       new Instructor { FirstMidName = "Kim",     LastName = "Abercrombie", HireDate = DateTime.Parse("1995-03-11"), OfficeAssignment = new OfficeAssignment { Location = "Smith 17" } },
       new Instructor { FirstMidName = "Fadi",    LastName = "Fakhouri",    HireDate = DateTime.Parse("2002-07-06"), OfficeAssignment = new OfficeAssignment { Location = "Gowan 27" } },
       new Instructor { FirstMidName = "Roger",   LastName = "Harui",       HireDate = DateTime.Parse("1998-07-01"), OfficeAssignment = new OfficeAssignment { Location = "Thompson 304" } },
       new Instructor { FirstMidName = "Candace", LastName = "Kapoor",      HireDate = DateTime.Parse("2001-01-15") },
       new Instructor { FirstMidName = "Roger",   LastName = "Zheng",       HireDate = DateTime.Parse("2004-02-12") }
   };
   instructors.ForEach(s => context.Instructors.AddOrUpdate(i => i.LastName, s));
   context.SaveChanges();
   
   var departments = new List<Department>
   {
       new Department { Name = "English",     Budget = 350000, StartDate = DateTime.Parse("2007-09-01"), PersonID = 1 },
       new Department { Name = "Mathematics", Budget = 100000, StartDate = DateTime.Parse("2007-09-01"), PersonID = 2 },
       new Department { Name = "Engineering", Budget = 350000, StartDate = DateTime.Parse("2007-09-01"), PersonID = 3 },
       new Department { Name = "Economics",   Budget = 100000, StartDate = DateTime.Parse("2007-09-01"), PersonID = 4 }
   };
   departments.ForEach(s => context.Departments.AddOrUpdate(d => d.Name, s));
   context.SaveChanges();
   
   var courses = new List<Course>
   {
       new Course { CourseID = 1050, Title = "Chemistry",      Credits = 3, DepartmentID = 3 },
       new Course { CourseID = 4022, Title = "Microeconomics", Credits = 3, DepartmentID = 4 },
       new Course { CourseID = 4041, Title = "Macroeconomics", Credits = 3, DepartmentID = 4 },
       new Course { CourseID = 1045, Title = "Calculus",       Credits = 4, DepartmentID = 2 },
       new Course { CourseID = 3141, Title = "Trigonometry",   Credits = 4, DepartmentID = 2 },
       new Course { CourseID = 2021, Title = "Composition",    Credits = 3, DepartmentID = 1 },
       new Course { CourseID = 2042, Title = "Literature",     Credits = 4, DepartmentID = 1 }
   };
   courses.ForEach(s => context.Courses.AddOrUpdate(s));
   context.SaveChanges();
   
   courses[0].Instructors.Add(instructors[0]);
   courses[0].Instructors.Add(instructors[1]);
   courses[1].Instructors.Add(instructors[2]);
   courses[2].Instructors.Add(instructors[2]);
   courses[3].Instructors.Add(instructors[3]);
   courses[4].Instructors.Add(instructors[3]);
   courses[5].Instructors.Add(instructors[3]);
   courses[6].Instructors.Add(instructors[3]);
   context.SaveChanges();
   

2. Las referencias a List tienen líneas onduladas rojas bajo ellas porque aún no tienen una instrucción using para su espacio de nombres. Haga clic con el botón derecho en una de las instancias de List y seleccione Resolver, luego elija Usar System.Collections.Generic.

   

   Esta selección de menú agrega el código siguiente a las using instrucciones cerca de la parte superior del archivo.

   using System.Collections.Generic;
   

3. Presione CTRL-SHIFT-B para compilar el proyecto.

El proyecto ya está listo para implementar la base de datos ContosoUniversity . Después de implementar la aplicación, la primera vez que la ejecute y vaya a una página que acceda a la base de datos, Code First creará la base de datos y ejecutará este Seed método.

Creación de scripts para la implementación de bases de datos de pertenencia

La aplicación Contoso University utiliza el sistema de membresía de ASP.NET y formularios de autenticación para autenticar y autorizar a los usuarios. La página Créditos de actualización solo es accesible para los usuarios que están en el rol Administrador.

Ejecute la aplicación y haga clic en Cursos y, a continuación, haga clic en Actualizar créditos.

Aparece la página Iniciar sesión porque la página Créditos de actualización requiere privilegios administrativos.

Escriba admin como nombre de usuario y devpwd como contraseña y haga clic en Iniciar sesión.

Aparece la página Créditos de actualización .

La información de usuario y rol se encuentra en la base de datos aspnet-ContosoUniversity especificada por la cadena de conexión DefaultConnection en el archivo Web.config .

Entity Framework Code First no administra esta base de datos, por lo que no se pueden usar migraciones para implementarla. Usará el proveedor dbDacFx para implementar el esquema de base de datos y configurará el perfil de publicación para ejecutar un script que insertará datos iniciales en tablas de base de datos.

Aquí también, normalmente usted no quiere los mismos datos en producción que tiene en desarrollo. Al implementar un sitio por primera vez, es habitual excluir la mayoría o todas las cuentas de usuario que cree para las pruebas. Por lo tanto, el proyecto descargado tiene dos bases de datos de pertenencia: aspnet-ContosoUniversity.mdf con usuarios de desarrollo y aspnet-ContosoUniversity-Prod.mdf con usuarios de producción. En este tutorial, los nombres de usuario son los mismos en ambas bases de datos: admin y nonadmin. Ambos usuarios tienen la contraseña devpwd en la base de datos de desarrollo y prodpwd en la base de datos de producción.

Desplegará los usuarios de desarrollo en el entorno de prueba y los usuarios de producción en preproducción y producción. Para ello, creará dos scripts SQL en este tutorial, uno para desarrollo y otro para producción y, en tutoriales posteriores, configurará el proceso de publicación para ejecutarlos.

Puede crear scripts de implementación de datos manualmente, mediante SQL Server Management Studio (SSMS) o mediante una herramienta de terceros. Este resto de este tutorial le mostrará cómo hacerlo en SSMS, pero si no desea instalar y usar SSMS, puede obtener los scripts de la versión completa del proyecto y pasar a la sección donde los almacena en la carpeta de la solución.

Para instalar SSMS, instálelo desde el Centro de descarga: Microsoft SQL Server 2012 Express haciendo clic en ENU\x64\SQLManagementStudio_x64_ENU.exe o ENU\x86\SQLManagementStudio_x86_ENU.exe. Si elige el incorrecto para el sistema, no podrá instalarlo y puede probar el otro.

(Tenga en cuenta que se trata de una descarga de 600 megabytes. Puede tardar mucho tiempo en instalarse y requerirá un reinicio del equipo).

En la primera página del Centro de instalación de SQL Server, haga clic en Nueva instalación independiente de SQL Server o agregue características a una instalación existente y siga las instrucciones, aceptando las opciones predeterminadas.

Creación del script de base de datos de desarrollo

1. Ejecute SSMS.

2. En el cuadro de diálogo Conectar al servidor , escriba (localdb)\v11.0 como nombre del servidor, deje Autenticación establecida en Autenticación de Windows y, a continuación, haga clic en Conectar.

   

3. En la ventana Explorador de objetos, expanda Bases de datos, haga clic con el botón derecho en aspnet-ContosoUniversity, haga clic en Tareasy, a continuación, haga clic en Generar scripts.

   

4. En el cuadro de diálogo Generar y publicar scripts , haga clic en Establecer opciones de scripting.

   Puede omitir el paso Elegir objetos porque el valor predeterminado es Escribir el script de toda la base de datos y todos los objetos de la base de datos, que es lo que necesita.

5. Haz clic en Avanzado.

   

6. En el cuadro de diálogo Opciones avanzadas de scripting, desplácese hacia abajo hasta Tipos de datos a incluir en el script y haga clic en la opción Datos únicamente de la lista desplegable.

7. Cambie Script USE DATABASE por False. Las instrucciones USE no son válidas para Azure SQL Database y no son necesarias para la implementación en SQL Server Express en el entorno de prueba.

   

8. Haz clic en Aceptar.

9. En el cuadro de diálogo Generar y publicar scripts , el cuadro Nombre de archivo especifica dónde se creará el script. Cambie la ruta de acceso a la carpeta de la solución (la carpeta que tiene el archivo ContosoUniversity.sln) y el nombre de archivo a aspnet-data-dev.sql.

10. Haga clic en Siguiente para ir a la pestaña Resumen y, a continuación, haga clic en Siguiente de nuevo para crear el script.

    

11. Haga clic en Finalizar

Creación del script de base de datos de producción

Puesto que no ha ejecutado el proyecto con la base de datos de producción, aún no está asociado a la instancia de LocalDB. Por lo tanto, primero debe adjuntar la base de datos.

1. En el Explorador de objetos de SSMS, haga clic con el botón derecho en Bases de datos y haga clic en Asociar.

   

2. En el cuadro de diálogo Adjuntar bases de datos , haga clic en Agregar y, a continuación, vaya al archivo aspnet-ContosoUniversity-Prod.mdf en la carpeta App_Data .

   

3. Haz clic en Aceptar.

4. Siga el mismo procedimiento que usó anteriormente para crear un script para el archivo de producción. Asigne al archivo de script el nombre aspnet-data-prod.sql.

Resumen

Ambas bases de datos ya están listas para implementarse y tiene dos scripts de implementación de datos en la carpeta de la solución.

En el siguiente tutorial, configurará las opciones de proyecto que afectan a la implementación, y establecerá transformaciones automáticas de archivos Web.config para configuraciones que deben ser diferentes en la aplicación desplegada.

Más Información

Para obtener más información sobre NuGet, consulte Administración de bibliotecas de proyectos con NuGet y documentación de NuGet. Si no desea usar NuGet, deberá aprender a analizar un paquete NuGet para determinar qué hace cuando se instala. (Por ejemplo, puede configurar Web.config transformaciones, configurar scripts de PowerShell para que se ejecuten en tiempo de compilación, etc.) Para obtener más información sobre cómo funciona NuGet, consulte Creación y publicación de un paquete ytransformaciones de código fuente y archivos de configuración.