Configurar um documento de índice - Amazon Simple Storage Service
Pastas e documentos de índiceConfigurar um documento de índice

Configurar um documento de índice

Ao habilitar a hospedagem de sites, você também deve configurar e fazer upload de um documento de índice. Um documento de índice é uma página da Web que o Amazon S3 retorna quando uma solicitação é feita para a raiz de um site ou para qualquer subpasta. Por exemplo, se um usuário insere http://www.example.com no navegador, ele não está solicitando nenhuma página específica. Nesse caso, o Amazon S3 exibe o documento de índice, que às vezes é referido como a página padrão.

Quando você habilita a hospedagem de sites estáticos para seu bucket, insere o nome do documento de índice (por exemplo, index.html). Depois de habilitar a hospedagem de sites estáticos para seu bucket, faça upload de um arquivo HTML com o nome do documento de índice para o bucket.

A barra no final do URL no nível raiz é opcional. Por exemplo, se você configurar seu site com index.html como o documento de índice, qualquer um dos URLs a seguir retornará index.html.

http://example-bucket.s3-website.Region.amazonaws.com/
http://example-bucket.s3-website.Region.amazonaws.com

Para obter mais informações sobre endpoints de site do Amazon S3, consulte Endpoints de site.

Pastas e documentos de índice

No Amazon S3, um bucket é um contêiner de objetos simples. Ele não fornece nenhuma organização hierárquica, já que o sistema de arquivos em seu computador faz isso. No entanto, você pode criar uma hierarquia lógica usando nomes de chaves de objetos que envolvam uma estrutura de pastas.

Por exemplo, considere um bucket com três objetos e que tenha os nomes de chaves a seguir. Embora esses objetos sejam armazenados sem uma organização hierárquica física, você pode pressupor a seguinte estrutura lógica de pastas com base nos nomes das chaves.

  • sample1.jpg: o objeto está na raiz do bucket.

  • photos/2006/Jan/sample2.jpg: o objeto está na subpasta photos/2006/Jan.

  • photos/2006/Feb/sample3.jpg: o objeto está na subpasta photos/2006/Feb.

No console do Amazon S3, você também pode criar uma pasta em um bucket. Por exemplo, você pode criar uma pasta chamada photos. Você pode fazer upload de objetos no bucket ou na pasta photos no bucket. Se você adicionar o objeto sample.jpg ao bucket, o nome da chave será sample.jpg. Se você fizer upload do objeto na pasta photos, o nome da chave de objeto será photos/sample.jpg.

Se você criar um estrutura de pastas em seu bucket, deverá ter um documento de índice em cada nível. Em cada pasta, o documento de índice deve ter o mesmo nome, por exemplo, index.html. Quando um usuário especificar um URL que se assemelhe a uma consulta de pasta, a presença ou a ausência de uma barra no final determinará o comportamento do site. Por exemplo, o URL a seguir, com uma barra no final, retorna o documento de índice photos/index.html. 

http://bucket-name.s3-website.Region.amazonaws.com/photos/

Contudo, se você excluir a barra no final do URL anterior, o Amazon S3 procurará primeiro um objeto photos no bucket. Se o objeto photos não for encontrado, ele procurará um documento de índice, photos/index.html. Se esse documento for encontrado, o Amazon S3 retornará uma mensagem 302 Found e apontará para a chave photos/. Para solicitações subsequentes a photos/, o Amazon S3 retorna photos/index.html. Se o documento de índice não for encontrado, o Amazon S3 retornará um erro.

Configurar um documento de índice

Para configurar um documento de índice usando o console do S3, use o procedimento a seguir. Você também pode configurar um documento de índice usando a API REST, os AWS SDKs, a AWS CLI ou o AWS CloudFormation.

nota

Em um bucket com versionamento habilitado, é possível carregar várias cópias do index.html, mas somente a versão mais recente será resolvida. Para obter mais informações sobre como usar o versionamento do S3, consulte Reter várias versões de objetos com o Versionamento do S3.

Quando você habilita a hospedagem de sites estáticos para seu bucket, insere o nome do documento de índice (por exemplo, index.html). Depois de habilitar a hospedagem de sites estáticos para seu bucket, faça upload de um arquivo HTML com esse nome de documento de índice para o bucket.

Como configurar o documento de índice

  1. Criar um arquivo index.html

    Se você não tiver um arquivo index.html, poderá usar o HTML a seguir para criar um:

    <html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>My Website Home Page</title>
</head>
<body>
  <h1>Welcome to my website</h1>
  <p>Now hosted on Amazon S3!</p>
</body>
</html>

  2. Salve o arquivo de índice localmente.

    O nome do documento de índice deve corresponder exatamente ao nome do documento de índice que você inseriu na caixa de diálogo Hospedagem de site estático. O nome do documento de índice diferencia maiúsculas de minúsculas. Por exemplo, se você inserir index.html no nome do Documentos de índice na caixa de diálogo Hospedagem de site estático, o nome do arquivo do documento de índice também deverá ser index.html e não Index.html.

  3. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  4. Na lista Buckets, selecione o nome do bucket que você deseja usar para hospedar um site estático.

  5. Habilite a hospedagem de sites estáticos para seu bucket e insira o nome exato do documento de índice (por exemplo, index.html). Para obter mais informações, consulte Habilitar a hospedagem de sites.

    Depois de habilitar a hospedagem estática do site, vá para a etapa 6.

  6. Para fazer upload do documento de índice para o bucket, siga um destes procedimentos:

    • Arraste e solte o arquivo de índice na listagem de buckets do console.

    • Escolha Upload (Fazer upload) e siga as instruções para escolher e fazer upload do arquivo de índice.

    Para obter instruções detalhadas, consulte Fazer upload de objetos.

  7. (Opcional) Faça upload do conteúdo de outro site para o seu bucket.

Depois, é necessário definir permissões para acesso ao site. Para mais informações, consulte Configuração de permissões para acesso ao site.

Também é possível configurar um documento de erro, o registro em log do tráfego da web ou um redirecionamento.