Descargar SolrDotnetSample - Descargar el código fuente de SolrDotnetSample

SolrDotnetSample

Otras categorias

1.0.0

Descargar

Muestra con .NET Core y Solrnet

.NET núcleo Aplicación de la consola - Docker Image CI Webapi - Docker Image CI

Este proyecto tiene como objetivo explorar el funcionamiento de SolRNet en el consumo del servicio SOLR SOLR en proyectos. Núcleo neto.

Empezando

Después del proyecto clon y siga los pasos descritos en el paso de instalación.

git clone https://github.com/AntonioFalcao/SolrDotnetSample.git

Requisitos previos

El entorno es necesario con los siguientes recursos:

.NET Core SDK: el marco utilizado.

Para verificar esta funcionalidad:

dotnet --version

Para más detalles

dotnet --info

Entity Framework Core .NET Command -line Herramientas: el servicio ORM utilizado.

Para instalar:

dotnet tool install --global dotnet-ef

Para verificar esta funcionalidad:

dotnet-ef --version

Docker: la plataforma de contenedores utilizada

Para verificar esta funcionalidad:

docker --version

Instalación

Con el uso de la contenedorización , prácticamente podemos aprovisionar la infraestructura necesaria.

Inicialmente, utilizaremos el servicio SOLR para satisfacer la necesidad de un motor de búsqueda a través de la composición ./solr-compose .

docker-compose -f solr-compose.yml up -d

El índice estándar, denominado núcleo Solr se define como my_core en entrypoint , así como la asignación de puerto estándar 8983:8983 :

 services : 
# comment for brevity
    ports :
      - " 8983:8983 "
    entrypoint :
      - solr-precreate
      - my_core
# comment for brevity

Definición de campos

La definición de los campos en el SOLR es un paso esencial, para garantizar que los datos tengan la misma representación deseada por el modelo.

Hay dos formas de hacerlo, una de ellas es definir los detalles de los campos en Schema.xml, la otra forma es hacer llamadas directas a la API del servicio. Para la segunda alternativa, existe el archivo Solr-Add-Fields.http disponible en el proyecto:

 POST http://localhost:8983/solr/my_core/schema
Content-Type: application/json

{
   "add-field" :{
      "name" : " Description " ,
      "type" : " string " ,
      "stored" : true
      },
   "add-field" :{
      "name" : " Title " ,
      "type" : " string " ,
      "stored" : true
      },
}

### comment for brevity

Sembrar datos en el solr

Una vez que aprovisionó el entorno y configuramos los campos, podemos sembrar datos a través de los pasos:

Aplique migraciones de núcleo EF, que ya estarán a cargo de la semilla a DB relacional.

En esta etapa, la siembra de datos se producirá a la DB relacional.

dotnet ef database update -s ./src/SolrDotnetSample.WebApi/ -p ./src/SolrDotnetSample.Repositories/

Realice la aplicación de la consola y seleccione la opción de siembra para SOLR.

Estarán disponibles dos opciones y
Generar nuevos datos.
Migrar datos relacionales.

docker build -t seed -f ./consoleApp.Dockerfile . && docker run -it seed

Ejecutando las pruebas

Pruebas automatizadas

Las pruebas de unidad y de integración se pueden ejecutar con su comando:

dotnet test

Pruebas funcionales

Para ejecutar las pruebas funcionalmente, debemos ejecutar inicialmente el proyecto para que el servicio web esté disponible.

docker build -t webapi -f ./webApi.Dockerfile . && docker run -p 5000:5000 webapi

El enrutamiento sigue el estándar http://hostname:port/api/v{version}/controller

Para hacer llamadas, puede estar utilizando el archivo ./basic-api-call.http a través de la extensión del cliente REST, por ejemplo:.

/api/v1/... usa la base de datos relacional.
/api/v2/... usa el solr

 ### V1 - Relational DB
GET http://localhost:5000/api/v1/posts

### V2 - NoSql DB
GET http://localhost:5000/api/v2/posts

### V1 - Relational DB
POST http://localhost:5000/api/v1/posts
Content-Type: application/json

{
  "Description" : " Description " ,
  "ExpiryDate" : " 2020-01-01 " ,
  "IsActive" : true ,
  "IsSold" : true ,
  "PostDate" : " 2020-01-01 " ,
  "Price" : 0 ,
  "Title" : " Title "
}

### comment for brevity