Tutorial: Criar um pipeline que usa o Amazon S3 como um provedor de implantação

Para enviar arquivos para o seu CodeCommit repositório

1. Extraia os exemplos de arquivos obtidos por download. Não faça upload do ZIP arquivo para o seu repositório.

2. Envie ou envie os arquivos para o seu CodeCommit repositório. Esses arquivos são o artefato de origem criado pelo assistente Create Pipeline para sua ação de implantação em CodePipeline. Os arquivos devem ter a seguinte aparência em seu diretório local:

   index.html
   main.css
   graphic.jpg

3. Você pode usar o Git ou o CodeCommit console para carregar seus arquivos:

   1. Para usar a linha de comando Git a partir de um repositório clonado no computador local:

      1. Execute o seguinte comando para organizar todos os seus arquivos de uma só vez:

         git add -A

      2. Execute o seguinte comando para confirmar os arquivos com uma mensagem de confirmação:

         git commit -m "Added static website files"

      3. Execute o comando a seguir para enviar os arquivos do seu repositório local para o seu CodeCommit repositório:

         git push

   2. Para usar o CodeCommit console para carregar seus arquivos:

      1. Abra o CodeCommit console e escolha seu repositório na lista Repositórios.

      2. Selecione Add file (Adicionar arquivo) e clique em Upload file (Carregar arquivo).

      3. Selecione Choose file (Escolher arquivo) e procure o arquivo. Informe seu nome de usuário e endereço de e-mail para confirmar a alteração. Escolha Commit changes (Confirmar alterações).

      4. Repita essa etapa para cada arquivo que deseja carregar.

Criar um pipeline com o assistente

1. Faça login no AWS Management Console e abra o CodePipeline console em http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).

3. Em Step 1: Choose pipeline settings (Etapa 1: selecionar as configurações do pipeline), em Pipeline name (Nome do pipeline), insira MyS3DeployPipeline.

4. Em Tipo de pipeline, escolha V2. Para obter mais informações, consulte Tipos de pipeline. Escolha Próximo.

5. Em Função de serviço, escolha Nova função de serviço para permitir CodePipeline a criação de uma função de serviço emIAM.

6. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

7. Em Step 2: Add source stage (Etapa 2: Adicionar estágio de origem), em Source provider (Fornecedor de origem), escolha AWS CodeCommit. Em Nome do repositório, escolha o nome do CodeCommit repositório em que você criou. Etapa 1: criar um CodeCommit repositório Em Nome do ramo, selecione o nome do ramo que contém a última atualização do código. A não ser que você tenha criado outro ramo, apenas main esta disponível.

   Depois de selecionar o nome do repositório e a filial, a regra Amazon CloudWatch Events a ser criada para esse pipeline é exibida.

   Escolha Próximo.

8. Em Step 3: Add build stage (Etapa 3: Adicionar estágio de construção), selecione Skip build stage (Pular estágio de compilação) e aceite a mensagem de aviso ao clicar novamente em Skip (Pular).

   Escolha Próximo.

9. Em Step 4: Add deploy stage (Etapa 4: Adicionar estágio de implantação):

   1. Em Deploy provider (Provedor de implantação), escolha Amazon S3.

   2. Em Bucket, insira o nome do seu bucket público.

   3. Selecione Extract file before deploy (Extrair arquivo antes de implantar).

      nota

      A implantação falhará se você não selecionar Extrair arquivo antes da implantação. Isso ocorre porque a AWS CodeCommit ação em seu pipeline compacta os artefatos de origem e seu arquivo é um ZIP arquivo.

      Quando Extract file before deploy (Extrair arquivo antes de implantar) for selecionado, o Deployment path (Caminho de implantação) será exibido. Insira no nome do caminho que você deseja usar. Isso cria uma estrutura de pastas no Amazon S3 para a qual os arquivos são extraídos. Para esse tutorial, deixe esse campo em branco.

      

   4. (Opcional) Em Predefinido ACL, você pode aplicar um conjunto de concessões predefinidas, conhecido como enlatado ACL, aos artefatos enviados.

   5. (Opcional) Em Cache control (Controle de cache), insira os parâmetros de armazenamento em cache. Você pode definir isso para controlar o comportamento do armazenamento em cache para solicitações/respostas. Para valores válidos, consulte o campo de Cache-Controlcabeçalho para HTTP operações.

   6. Escolha Próximo.

10. Em Etapa 5: Revisar, revise as informações e, então selecione Criar pipeline.

11. Depois que o pipeline for executado com êxito, abra o console do Amazon S3 e verifique se os arquivos aparecem no bucket público, conforme mostrado:

    index.html
    main.css
    graphic.jpg

12. Acesse o endpoint para testar o site. O endpoint segue este formato: http://bucket-name.s3-website-region.amazonaws.com/.

    Exemplo do endpoint: http://my-bucket.s3-website-us-west-2.amazonaws.com/.

    A página da web a seguir é exibida.

criar um arquivo buildspec.yml

• Crie um arquivo denominado buildspec.yml com o seguinte conteúdo: Esses comandos de compilação instalam TypeScript e usam o TypeScript compilador para reescrever o código no index.ts código. JavaScript

  version: 0.2
  
  phases:
    install:
      commands:
        - npm install -g typescript
    build:
      commands:
        - tsc index.ts
  artifacts:
    files:
      - index.js

Criar um arquivo index.ts

• Crie um arquivo denominado index.ts com o seguinte conteúdo:

  interface Greeting {
      message: string;
  }
  
  class HelloGreeting implements Greeting {
      message = "Hello!";
  }
  
  function greet(greeting: Greeting) {
      console.log(greeting.message);
  }
  
  let greeting = new HelloGreeting();
  
  greet(greeting);

Como fazer upload de arquivos para o bucket de origem do S3

1. Os arquivos devem ter a seguinte aparência em seu diretório local:

   buildspec.yml
   index.ts

   Compacte os arquivos e nomeie o arquivo source.zip.

2. No console do Amazon S3, para o bucket de origem, selecione Carregar. Escolha Adicionar arquivos e, em seguida, procure o ZIP arquivo que você criou.

3. Escolha Carregar. Esses arquivos são o artefato de origem criado pelo assistente Create Pipeline para sua ação de implantação em CodePipeline. O arquivo deve ter a seguinte aparência no bucket:

   source.zip

Criar um pipeline com o assistente

1. Faça login no AWS Management Console e abra o CodePipeline console em http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).

3. Em Step 1: Choose pipeline settings (Etapa 1: selecionar as configurações do pipeline), em Pipeline name (Nome do pipeline), insira MyS3DeployPipeline.

4. Em Função de serviço, escolha Nova função de serviço para permitir CodePipeline a criação de uma função de serviço emIAM.

5. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

6. Em Step 2: Add source stage (Etapa 2: adicionar estágio de origem), em Source provider (Provedor de origem), escolha Amazon S3. Em Bucket, escolha o nome do bucket de origem. Em Chave de objeto do S3, insira o nome do seu ZIP arquivo de origem. Certifique-se de incluir a extensão de arquivo .zip.

   Escolha Próximo.

7. Na Step 3: Add build stage (Etapa 3: adicionar estágio de compilação):

   1. Em Build provider (Provedor de compilação), escolha CodeBuild.

   2. Selecione Create build project (Criar projeto de compilação). Na página Create project (Criar projeto):

   3. Em Project name (Nome do projeto), insira um nome para esse projeto de compilação.

   4. Em Environment (Ambiente), escolha Managed image (Imagem gerenciada). Para Operating system, selecione Ubuntu.

   5. Em Runtime (Tempo de execução), selecione Standard (Padrão). Em Runtime version (Versão do tempo de execução), escolha aws/codebuild/standard:1.0.

   6. Na Image version (Versão da imagem), escolha Always use the latest image for this runtime version (Sempre usar a imagem mais recente para esta versão de tempo de execução).

   7. Em Função de serviço, escolha sua função de CodeBuild serviço ou crie uma.

   8. Para Build specifications (Especificações da compilação), escolha Use a buildspec file (Usar um arquivo buildspec).

   9. Escolha Continuar para CodePipeline. Uma mensagem será exibida se o projeto foi criado com sucesso.

   10. Escolha Próximo.

8. Em Step 4: Add deploy stage (Etapa 4: Adicionar estágio de implantação):

   1. Em Deploy provider (Provedor de implantação), escolha Amazon S3.

   2. Em Bucket, insira o nome do bucket de destino do S3.

   3. Certifique-se de que Extract file before deploy (Extrair arquivo antes de implantar) esteja desmarcada.

      Quando Extract file before deploy (Extrair arquivo antes de implantar) estiver desmarcado, a S3 object key (chave de objeto do S3) será exibida. Insira no nome do caminho que você deseja usar: js-application/{datetime}.zip.

      Isso cria uma pasta js-application no Amazon S3 para a qual os arquivos são extraídos. Nessa pasta, a variável {datetime} cria um timestamp em cada arquivo de saída quando o pipeline é executado.

      

   4. (Opcional) Em Predefinido ACL, você pode aplicar um conjunto de concessões predefinidas, conhecido como enlatado ACL, aos artefatos enviados.

   5. (Opcional) Em Cache control (Controle de cache), insira os parâmetros de armazenamento em cache. Você pode definir isso para controlar o comportamento do armazenamento em cache para solicitações/respostas. Para valores válidos, consulte o campo de Cache-Controlcabeçalho para HTTP operações.

   6. Escolha Próximo.

9. Em Etapa 5: Revisar, revise as informações e, então selecione Criar pipeline.

10. Depois que o pipeline for executado com êxito, visualize o bucket no console do Amazon S3. Verifique se o ZIP arquivo implantado é exibido no bucket de destino, abaixo da js-application pasta. O JavaScript arquivo contido no ZIP arquivo deve serindex.js. O arquivo index.js contém a seguinte saída:

    var HelloGreeting = /** @class */ (function () {
        function HelloGreeting() {
            this.message = "Hello!";
        }
        return HelloGreeting;
    }());
    function greet(greeting) {
        console.log(greeting.message);
    }
    var greeting = new HelloGreeting();
    greet(greeting);