Daniel.alves: Página substituída por 'Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando o Jenkins para os projetos desenvolvidos em .NET. O novo modelo...'

2016-10-28T15:54:16Z

Página substituída por 'Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando o Jenkins para os projetos desenvolvidos em .NET. O novo modelo...'

Mostrar alterações

Daniel.alves: /* Web.config */

2016-07-01T20:10:44Z

‎Web.config

Daniel.alves: /* Web.config */

2016-07-01T20:08:00Z

‎Web.config

Daniel.alves em 20h06min de 1 de julho de 2016

2016-07-01T20:06:55Z

Mostrar alterações

Daniel.alves: Criou página com 'Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando a plataforma Jenkins para os projetos que usam .NET. Para tanto, algumas...'

2016-06-29T19:51:24Z

Criou página com 'Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando a plataforma Jenkins para os projetos que usam .NET. Para tanto, algumas...'

Página nova

Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando a plataforma Jenkins para os projetos que usam .NET.
Para tanto, algumas alterações no projeto são necessárias para que o Build possa ser executado utilizando-se o próprio ''MSBUILD'', e não a versão do Visual Studio no qual o sistema foi desenvolvido.

== Alterações necessárias no Projeto ==

=== Arquivos ''*.csproj'' ===
Nos arquivos do projeto com extensão .csproj é necessário localizar e comentar o seguinte bloco:

<syntaxhighlight lang="xml" line="1" >
<PropertyGroup>
<VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">10.0</VisualStudioVersion>
<VSToolsPath Condition="'$(VSToolsPath)' == ''">$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)</VSToolsPath>
</PropertyGroup>
</syntaxhighlight>

No exemplo acima, o sistema foi desenvolvido utilizando a versão 10.0 do Visual Studio, e para que o MSBUILD possa compilar o projeto faz-se necessário comentar ou remover o bloco <PropertyGroup>.

=== Version.xml ===

É necessário alterar a estrutura do arquivo ''version.xml'' para atender a necessidade do sistema de build. Vale ressaltar que, como alguns sistemas fazem a leitura deste arquivo, faz-se necessária a alteração no sistema para efetuar a correta leitura do novo arquivo.

Arquivo antigo:
<syntaxhighlight lang="xml" line="1" >
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<versionNumber>
<Major value="5" />
<Minor value="5" />
<Revision value="7" />
<Build value="1" />
</versionNumber>
</configuration>
</syntaxhighlight>

Arquivo novo:
<syntaxhighlight lang="xml" line="1" >
<?xml version="1.0" encoding="utf-8"?>
<Project
ToolsVersion="4.0"
DefaultTargets="Default"
xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<Major>5</Major>
<Minor>5</Minor>
<Revision>7</Revision>
<Build>1</Build>
</PropertyGroup>
</Project>
</syntaxhighlight>

=== Zip.targets ===

É necessário incluir na raiz da solução o arquivo ''Zip.targets'', que é responsável por compactar o pacote com o número da versão constante no arquivo ''version.xml''.
* Nota: A extensão do arquivo é .targets

Conteúdo do arquivo zip.targets

<syntaxhighlight lang="xml" line="1" >
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">



<UsingTask TaskName="Zip" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll">
<ParameterGroup>
<SourceFolder ParameterType="System.String" Required="true"/>
<OutputFileName ParameterType="System.String" Required="true" />
<NoBackup ParameterType="System.Boolean" Required="false" />
</ParameterGroup>
<Task>
<Reference Include="System.Core" />
<Reference Include="Microsoft.CSharp" />
<Reference Include="System.IO.Compression" />
<Reference Include="System.IO.Compression.FileSystem" />
<Using Namespace="System" />
<Using Namespace="System.IO" />
<Using Namespace="System.Net" />
<Using Namespace="System.Linq" />
<Using Namespace="System.Reflection" />
<Using Namespace="Microsoft.Build.Framework" />
<Using Namespace="Microsoft.Build.Utilities" />
<Using Namespace="System.IO.Compression" />
<Code Type="Fragment" Language="cs">
<![CDATA[
try {
SourceFolder = Path.GetFullPath(SourceFolder);
OutputFileName = Path.GetFullPath(OutputFileName);

Log.LogMessage("Package zip... (" + OutputFileName + " )");

// Prepare output temp file
var tmpFile = Path.ChangeExtension(OutputFileName, ".zip.tmp");
File.Delete(tmpFile);
// Zip folder
ZipFile.CreateFromDirectory(SourceFolder, tmpFile);
// Replace output file
File.Delete(OutputFileName);
File.Move(tmpFile, OutputFileName);
return true;
}
catch (Exception ex) {
Log.LogErrorFromException(ex);
return false;
}
]]>
</Code>
</Task>
</UsingTask>
</Project>
</syntaxhighlight>

=== Build.xml ===

Todo o processo de ''Build'' está atrelado ao arquivo ''build.xml'' desenvolvido para orquestrar a execução do ''build'' dos sistemas em .NET.
Este arquivo deve estar na raiz da solução.

A estrutura do arquivo é a seguinte:
<syntaxhighlight lang="xml" line="1" >
<?xml version="1.0" encoding="utf-8"?>
<Project
ToolsVersion="4.0"
DefaultTargets="Compile"
xmlns="http://schemas.microsoft.com/developer/msbuild/2003">


<Import Project="Zip.targets" />

<PropertyGroup>

<ProjectName>NomeDoSite</ProjectName>


<ProjectDir>$(ProjectName)\</ProjectDir>


<CSProjName>$(ProjectName).csproj</CSProjName>


<ProjectPath>$(ProjectDir)$(CSProjName)</ProjectPath>


<TargetDir>PackageBuild\</TargetDir>


<TargetBinDir>$(TargetDir)\bin</TargetBinDir>


<TargetBuildZip>Builds</TargetBuildZip>


<Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration>
<BuildPlatform Condition=" '$(BuildPlatform)' == '' ">Any CPU</BuildPlatform>
</PropertyGroup>

<ItemGroup>
<BuildArtifactsDir Include="$(TargetBinDir)\" />
<ProjectsToBuild Include="$(ProjectDir)\$(CSProjName)"/>
</ItemGroup>

<Import Project="$(ProjectDir)\version.xml" />


<Target Name="Clean">
<MakeDir Directories="$(TargetBuildZip)"/>
<RemoveDir Directories="$(TargetDir)" />
</Target>


<Target Name="CopyProject" DependsOnTargets="Clean">

<XmlPeek
Namespaces="<Namespace Prefix='msb' Uri='http://schemas.microsoft.com/developer/msbuild/2003'/>"
XmlInputPath="$(ProjectPath)"
Query="/msb:Project/msb:ItemGroup/msb:Content/@Include|/msb:Project/msb:ItemGroup/msb:EmbeddedResource/@Include">

<Output TaskParameter="Result" ItemName="Peeked" />

</XmlPeek>

<Copy
SourceFiles="@(Peeked->'$(ProjectDir)%(RelativeDir)%(Filename)%(Extension)')"
DestinationFiles="@(Peeked->'$(TargetDir)%(RelativeDir)%(Filename)%(Extension)')"/>

<Copy
SourceFiles="$(ProjectPath)"
DestinationFiles="$(ProjectDir)$(CSProjName)"/>

<MSBuild Projects="$(ProjectDir)$(CSProjName)"/>

</Target>


<Target Name="CleanBin" DependsOnTargets="CopyProject">
<RemoveDir Directories="$(TargetBinDir)" />
</Target>


<Target Name="BuildCompile" DependsOnTargets="CleanBin">
<MSBuild Projects="@(ProjectsToBuild)" Targets="Rebuild"
Properties="outdir=%(BuildArtifactsDir.FullPath);Configuration=$(Configuration)" />
</Target>


<Target Name="Zip" DependsOnTargets="BuildCompile" >
<Zip SourceFolder="$(TargetDir)" OutputFileName="$(TargetBuildZip)\$(ProjectName)_$(Major).$(Minor).$(Revision).$(Build).zip" />
</Target>


<Target Name="Compile" DependsOnTargets="Zip">
<RemoveDir Directories="$(TargetDir)" />
</Target>

</Project>
</syntaxhighlight>

== Configurando o Build no Jenkins ==

@@ Linha 363: / Linha 363: @@
 </syntaxhighlight>
-Os arquivos relacionados com esse sistema são:
+Os arquivos relacionados com esse arquivo devem estar dentro da pasta configs na raiz do site, e são eles:
 ==== saml.config ====

@@ Linha 365: / Linha 365: @@
 Os arquivos relacionados com esse sistema são:
-* saml.config
+==== saml.config ====
 <syntaxhighlight lang="xml" line="1" >
 <ServiceProvider id="http://localhost:59494/Account" xmlns="urn:MSTech.SAML20.Configuration">
@@ Linha 376: / Linha 376: @@
 </syntaxhighlight>
-* log4net.config
+==== log4net.config ====
 <syntaxhighlight lang="xml" line="1" >
 <log4net debug="true">
@@ Linha 595: / Linha 595: @@
 </syntaxhighlight>
-*filestorage
+==== filestorage ====
 <syntaxhighlight lang="xml" line="1" >
 <!-- Quando utilizado o diretório virtual, necessário que o mesmo faça referência para ao diretório
@@ Linha 603: / Linha 603: @@
 </syntaxhighlight>
-*connection.config
+==== connection.config ====
 <syntaxhighlight lang="xml" line="1" >
 <connectionStrings>
@@ Linha 610: / Linha 610: @@
 </syntaxhighlight>
 == Configurando o Build no Jenkins ==

Build utilizando Jenkins - Histórico de revisão

Daniel.alves: Página substituída por 'Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando o Jenkins para os projetos desenvolvidos em .NET. O novo modelo...'

Daniel.alves: /* Web.config */

Daniel.alves: /* Web.config */

Daniel.alves em 20h06min de 1 de julho de 2016

Daniel.alves: Criou página com 'Esta página tem como objetivo orientar os colaboradores na correta configuração do Build utilizando a plataforma Jenkins para os projetos que usam .NET. Para tanto, algumas...'