Cake-Build addin that extends Cake with IIS extensions
- Implemented functionality
- Referencing
- Usage
- Example
- TroubleShooting
- Plays well with
- License
- Share the love
- Create Website / Ftpsite
- Delete Site
- Start Site
- Stop Site
- Site Exists
- Add site binding
- Remove site binding
- Create Application Pool
- Delete Pool
- Start Pool
- Stop Pool
- Pool Exists
- Recycle Pool
- Create site applications
- Create WebFarm
- Delete WebFarm
- Add server to WebFarm
- Delete server from WebFarm
- Server exists
- Take Server Offline
- Bring Server Online
- Set server Healthy
- Set server Unhealthy
- Set server Available
- Set server Unavailable Immediately
- Set server Unavailable Gracefully
- Is server Healthy
- Get server State
- Create Virtual Directory
- Delete Virtual Directory
- Virtual Directory Exists
- Create Global Rewrite Rules
- Delete Global Rewrite Rules
Cake.IIS is available as a nuget package from the package manager console:
Install-Package Cake.IISor directly in your build script via a cake addin directive:
#addin "Cake.IIS"#addin "Cake.IIS"
Task("ApplicationPool-Create")
.Description("Create a ApplicationPool")
.Does(() =>
{
CreatePool("remote-server-name", new ApplicationPoolSettings()
{
Name = "Production",
Username = "Admin",
Password = "pass1"
});
});
Task("ApplicationPool-Stop")
.Description("Stops a local ApplicationPool")
.Does(() =>
{
StopPool("Production");
});
Task("ApplicationPool-Start")
.Description("Starts a remote ApplicationPool")
.Does(() =>
{
StartPool("remote-server-name", "Production");
});
Task("Website-Create")
.Description("Create a Website")
.Does(() =>
{
CreateWebsite("remote-server-name", new WebsiteSettings()
{
Name = "MyBlog",
Binding = IISBindings.Http
.SetHostName("blog.website.com")
.SetIpAddress("*")
.SetPort(80),
PhysicalDirectory = "C:/Websites/Blog",
ApplicationPool = new ApplicationPoolSettings()
{
Name = "Production"
}
});
});
Task("Website-Stop")
.Description("Stops a remote Website")
.Does(() =>
{
StopSite("remote-server-name", "MyBlog");
});
Task("Website-Start")
.Description("Starts a local Website")
.Does(() =>
{
StartSite("MyBlog");
});
Task("Binding-Add")
.Description("Adds a binding to a website")
.Does(() =>
{
AddBinding("MyBlog", new BindingSettings(BindingProtocol.Http)
{
HostName = "myblog.com"
});
});
Task("Binding-Add-Fluent")
.Description("Adds a binding to a website using a fluent interface")
.Does(() =>
{
AddBinding("remote-server-name", "MyBlog", IISBindings.Http
.SetIpAddress("127.0.0.1")
.SetPort(8080));
});
Task("Binding-Remove")
.Description("Removes a binding from a website")
.Does(() =>
{
RemoveBinding("remote-server-name", "MyBlog", new BindingSettings(BindingProtocol.Http)
{
HostName = "myblog.com"
});
});
Task("Application-Create")
.Description("Adds an application to a site")
.Does(() =>
{
AddSiteApplication(new ApplicationSettings()
{
SiteName = "Default Website",
ApplicationPath = "/NestedApp",
VirtualDirectory = "/NestedApp",
PhysicalDirectory = "C:/Apps/KillerApp/"
});
});
Task("Application-Remove")
.Description("Remove an application from a site")
.Does(() =>
{
RemoveSiteApplication(new ApplicationSettings()
{
SiteName = "Default Website",
ApplicationPath = "/NestedApp",
VirtualDirectory = "/NestedApp",
PhysicalDirectory = "C:/Apps/KillerApp/"
});
});
Task("WebFarm-Create")
.Description("Create a WebFarm")
.Does(() =>
{
CreateWebFarm("remote-server-name", new WebFarmSettings()
{
Name = "Batman",
Servers = new string[] { "Gotham", "Metroplis" }
});
});
Task("WebFarm-Server-Online")
.Description("Sets a WebFarm server as online")
.Does(() =>
{
BringServerOnline("remote-server-name", "Batman", "Gotham");
});
Task("WebFarm-Server-Offline")
.Description("Sets a WebFarm server as offline")
.Does(() =>
{
TakeServerOffline("remote-server-name", "Batman", "Gotham");
});
Task("WebFarm-Server-Unavailable-Gracefully")
.Description("Sets a WebFarm server as unavailable gracefully")
.Does(() =>
{
SetServerUnavailableGracefully("remote-server-name", "Batman", "Gotham");
});
Task("WebFarm-Server-Unavailable-Immediately")
.Description("Sets a WebFarm server as unavailable immediately")
.Does(() =>
{
SetServerUnavailableImmediately("remote-server-name", "Batman", "Gotham");
});
Task("WebFarm-Add-Server")
.Description("Add a Server to a WebFarm")
.Does(() =>
{
AddServer("remote-server-name", "farm-name", new WebFarmServerSettings
{
Address = "webfarm-server-adress",
HttpPort = 8080
});
});
Task("VirtualDirectory-Create")
.Description("Creates a Virtual Directory")
.Does(() =>
{
AddSiteVirtualDirectory("remote-server-name", new VirtualDirectorySettings(){
PhysicalDirectory = "C:/Apps/Directory/",
SiteName = "Default Website",
ApplicationPath = "/",
Path = "/Directory"
});
});
Task("VirtualDirectory-Remove")
.Description("Removes a Virtual Directory")
.Does(() =>
{
RemoveSiteVirtualDirectory("remote-server-name", new VirtualDirectorySettings(){
SiteName = "Default Website",
ApplicationPath = "/",
Path = "/Directory"
});
});
Task("VirtualDirectory-Exists")
.Description("Checks if a Virtual Directory exists")
.Does(() =>
{
SiteVirtualDirectoryExists("remote-server-name", new VirtualDirectorySettings(){
SiteName = "Default Website",
ApplicationPath = "/",
Path = "/Directory"
});
});
Task("RewriteRule-Create")
.Description("Create a new rewrite global rule")
.Does(() =>
{
CreateRewriteRule("remote-server-name", new RewriteRuleSettings
{
Name = "Redirect to HTTPS",
Pattern = "*",
PatternSintax = RewritePatternSintax.Wildcard,
IgnoreCase = true,
StopProcessing = true,
Conditions = new []
{
new RewriteRuleConditionSettings { ConditionInput = "{HTTPS}", Pattern = "off", IgnoreCase = true },
},
Action = new RewriteRuleRedirectAction { Url = @"https://{HTTP_HOST}{REQUEST_URI}", RedirectType = RewriteRuleRedirectType.Found }
});
});
Task("RewriteRule-Delete")
.Description("Delete a rewrite global rule")
.Does(() =>
{
DeleteRewriteRule("remote-server-name", "rule-name");
});
RunTarget("Website-Create");A complete Cake example can be found here.
- Please be aware of the breaking changes that occurred with the release of Cake v0.22.0, you will need to upgrade Cake in order to use Cake.IIS v0.3.0 or above.
A few pointers for managing IIS can be found here.
If your looking to deploy to IIS its worth checking out Cake.WebDeploy or if your running a WebFarm inside AWS then check out Cake.AWS.ElasticLoadBalancing.
If your looking for a way to trigger cake tasks based on windows events or at scheduled intervals then check out CakeBoss.
Copyright (c) 2015 - 2016 Sergio Silveira, Phillip Sharpe
Cake.IIS is provided as-is under the MIT license. For more information see LICENSE.
If this project helps you in anyway then please ⭐ the repository.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
