As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instalar um recurso do Windows: IIS
<a name="cookbooks-101-opsworks-install-software-feature"></a>

**Importante**  
O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no [AWS re:POST](https://repost.aws/) ou por meio do Premium [AWS Support](https://aws.amazon.com/support).

 Os recursos do Windows são um conjunto de componentes opcionais do sistema, incluindo .NET Framework e Internet Information Services (IIS). Este tópico descreve como implementar um livro de receitas para instalar um atributo comum, o Internet Information Services (IIS).

**nota**  
[Instalar um pacote](cookbooks-101-opsworks-install-software-package.md) mostra como instalar softwares fornecidos em um pacote de instalação, como um arquivo MSI, que você deve baixar para a instância e executar. [Livros de receitas do IIS](https://github.com/opscode-cookbooks/iis) 

[Executar uma receita na instância Windows](cookbooks-101-opsworks-opsworks-windows.md) mostra como usar um recurso `powershell_script` para instalar um recurso do Windows. Este exemplo mostra uma abordagem alternativa: usar o recurso [ do ](https://github.com/opscode-cookbooks/windows)livro de receitas do Windows`windows_feature` do Chef. Este livro de receitas contém um conjunto de recursos que usa o [Deployment Image Servicing and Management](https://technet.microsoft.com/en-us/library/dd744256%28v=ws.10%29.aspx) para executar várias tarefas no Windows, incluindo o recurso de instalação.

**nota**  
O Chef também tem um livro de receitas do IIS, que você pode usar para gerenciar o IIS. Para obter mais informações, consulte [livro de receitas do IIS](https://github.com/opscode-cookbooks/iis).

**Para configurar o livro de receitas**

1. Acesse o [ GitHub repositório de livros de receitas do Windows e baixe o `windows` livro](https://github.com/opscode-cookbooks/windows) de receitas.

   Este exemplo supõe que você fará download do repositório `windows` como um arquivo .zip, mas também poderá clonar o repositório se preferir.

1. Acesse o [ GitHub repositório de livros de receitas chef\$1handler e baixe o livro de receitas](https://github.com/opscode-cookbooks/chef_handler). `chef-handler`

   O livro de receitas `windows` depende de `chef_handler`; você não o usará diretamente. Este exemplo supõe que você fará download do repositório `chef_handler` como um arquivo .zip, mas também poderá clonar o repositório se preferir.

1. Extraia os livros de receitas `windows` e `chef_handler` em diretórios no seu diretório de livros de receitas chamados `windows` e `chef_handler`, respectivamente.

1. Crie um diretório em seu diretório de livros de receitas chamado `install-iis` e navegue até ele.

1. Adicione um arquivo `metadata.rb` a `install-iis`, com o seguinte conteúdo.

   ```
   name "install-iis"
   version "0.1.0"
   
   depends "windows"
   ```

   A diretriz `depends` permite que você use os recursos do livro de receitas `windows` em suas receitas.

1. Crie um diretório `recipes` em `install-iis` e adicione um arquivo chamado `default.rb` ao diretório que contém o seguinte código de receita.

   ```
   %w{ IIS-WebServerRole IIS-WebServer }.each do |feature|
     windows_feature feature do
       action :install
     end
   end
   
   service 'w3svc' do
     action [:start, :enable]
   end
   ```

   A receita usa o recurso `windows_feature` do livro de receitas do `windows` para instalar o seguinte:

   1. A [função do Servidor Web do IIS](https://technet.microsoft.com/en-us/library/cc770634.aspx).

   1. O [Servidor Web do IIS](https://technet.microsoft.com/en-us/library/cc753433%28v=ws.10%29.aspx).

   Em seguida, a receita usa um recurso [https://docs.chef.io/chef/resources.html#service](https://docs.chef.io/chef/resources.html#service) para iniciar e ativar o serviço do IIS (W3SVC).
**nota**  
Para obter uma lista completa de recursos do Windows disponíveis, [use o RDP para fazer login na instância](workinginstances-rdp.md), abra uma janela de prompt de comando, e execute o comando a seguir. Observe que a lista é bastante extensa.  

   ```
   dism /online /Get-Features
   ```

1. Crie um arquivo `.zip` que contenha os livros de receitas `install-iis`, `chef_handler` e `windows` e carregue o arquivo em um bucket do S3. Torne público o arquivo e registre o URL para uso posterior. Este exemplo supõe que o nome do arquivo seja `install-iis.zip`. Para obter mais informações, consulte [Repositórios de livro de receitas](workingcookbook-installingcustom-repo.md).

   O conteúdo entregue aos buckets do Amazon S3 pode conter conteúdo do cliente. Para obter mais informações sobre a remoção de dados confidenciais, consulte [Como faço para esvaziar um bucket do S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/empty-bucket.html) ou [Como faço para excluir um bucket do S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html).

Crie uma pilha para este exemplo da seguinte maneira. Use também uma pilha existente do Windows. Basta atualizar os livros de receitas, como será descrito mais tarde.

**Criar uma pilha**

1. Abra o [console do OpsWorks Stacks](https://console.aws.amazon.com/opsworks/) e selecione **Add Stack (Adicionar pilha)**. Especifique as seguintes configurações, aceite os padrões para as outras configurações e escolha **Add Stack**.
   + **Nome**: InstallIIS
   + **Região**: Oeste dos EUA (Oregon)

     Este exemplo funcionará em qualquer região, mas recomendamos o uso de Oeste dos EUA (Oregon) para tutoriais.
   + **Sistema operacional padrão**: Microsoft Windows Server 2012 R2

1. Clique em **Add a layer** e [adicione uma camada personalizada à pilha](workinglayers-custom.md) com as seguintes configurações.
   + **Nome**: IIS
   + **Nome curto**: iis

1. [Adicione uma instância ininterrupta](workinginstances-add.md) com as configurações padrão à camada IIS e [inicie-a](workinginstances-starting.md).

Agora você pode instalar o livro de receitas e executar a receita

**Para instalar o livro de receitas e executar a receita**

1. [Edite a pilha para habilitar livros de receitas personalizados](workingcookbook-installingcustom-enable.md), e especifique as seguintes configurações.
   + **Tipo de repositório**: **Arquivamento do S3**
   + **URL do repositório**: o URL do arquivo do livro de receitas que você registrou anteriormente.

   Aceite os valores padrão para as outras configurações e escolha **Save** para atualizar a configuração da pilha.

1. [Execute o comando de pilha **Update Custom Cookbooks**](workingstacks-commands.md), que instala a versão mais recente dos seus livros de receitas personalizado nas instâncias online da pilha. Se uma versão mais antiga de seus livros de receitas estiver presente, este comando a sobrescreverá.

1. Execute a receita acionando o comando de stack **Execute Recipes (Executar receitas)** com a opção **Recipes to execute (Receitas para executar)** definida como **install-iis::default**. Este comando inicia uma execução do Chef, que executa as receitas especificadas.
**nota**  
Este exemplo usa **Execute Recipes** por conveniência, mas normalmente você faz com que OpsWorks as pilhas [executem suas receitas automaticamente](workingcookbook-assigningcustom.md), atribuindo-as ao evento de ciclo de vida apropriado. Você pode executar essas receitas acionando manualmente o evento. Use um comando de stack para acionar eventos Setup e Configure, e um [comando de pilha](workingapps-deploying.md) para acionar eventos Deploy e Undeploy.

1. Para verificar a instalação, [use RDP para conectar à instância](workinginstances-rdp.md) e abrir o Windows Explorer. O sistema de arquivos agora tem um diretório `C:\inetpub`. Se você verificar a lista de serviços no aplicativo do painel de controle de ferramentas administrativas, o IIS deve estar próximo à parte inferior. No entanto, ele será chamado World Wide Web Publishing Service, em vez de IIS.