O cenário

O cenário para este tutorial simplifica a hospedagem da web para seus fundamentos para destacar as etapas envolvidas. Embora nem todas as opções de configuração sejam cobertas neste tutorial, a conclusão correta deste tutorial resulta em conteúdo acessível na web

Antes de começar

Assegure-se de que você tenha o que precisa para iniciar:

• Uma conta para a plataforma IBM Cloud
• Uma instância do IBM Cloud Object Storage
• Conteúdo em forma fixa, como texto (HTML seria perfeito) e arquivos de imagens

Verifique se você tem o acesso apropriado para a instância do IBM Cloud Object Storage que você usará ou as permissões adequadas para os depósitos que você usará para este tutorial.

Para uso da IBM Cloud com este tutorial, será necessário configurar o Object Storage plug-in para especificar a instância de serviço que você deseja usar e a região padrão na qual deseja que seu novo depósito seja criado.

Criar um depósito configurado para acesso público..

Criar um depósito para um website estático exigirá acesso público. Há várias opções para configurar o acesso público. Especificamente, o uso da ObjectReader IAM evitará a listagem do conteúdo do depósito enquanto ainda permite que o conteúdo estático seja visualizado na internet Se desejar permitir a visualização da listagem do conteúdo, use a ContentReader Função do IAM para seu depósito.

ibmcloud cos bucket-create --bucket <bucketname>

Fazer upload do conteúdo para seu depósito

O conteúdo de seus arquivos estáticos hospedados do website foca naturalmente em informações e mídia. Uma abordagem popular para criar conteúdo para websites estáticos são geradores de software livre listados em StaticGen. Para o propósito deste tutorial, precisamos apenas de dois arquivos:

• Uma página de índice, geralmente gravada em HTML e denominada index.html, que é carregada por padrão para visitantes em seu site
• Uma página de erro, também em HTML e aqui denominada error.html; geralmente, a página de erro é carregada quando um visitante tenta acessar um objeto que não está presente ou não tem acesso público

Outros arquivos, como imagens, PDFs ou vídeos, também podem ser enviados para o seu bucket (mas este tutorial focará apenas em um conjunto mínimo de requisitos).

Para o propósito deste tutorial, coloque as páginas HTML para o índice e a manipulação de erros em um diretório local Substitua o conteúdo do item temporário conforme mostrado no comando de exemplo para fazer upload de seus arquivos html:

ibmcloud cos object-put --bucket BUCKET_NAME --key KEY [--body FILE_PATH]

Você pode já ter concluído a configuração básica para hospedar o seu website estático Os arquivos podem ser transferidos por upload diretamente no Console quando você tiver nomeado e configurado seu depósito. Observe que a etapa é opcional, conforme mostrado na Figura 4, e pode ocorrer a qualquer momento antes do teste de seu novo site hospedado no host..

Para o restante do tutorial, assumiremos que a chave do objeto para a página do índice é index.html e a chave para o documento de erro é error.html, embora qualquer nome do arquivo apropriado possa ser usado para o sufixo ou chave.

Configure as opções para seu website

Há mais opções do que este tutorial pode descrever, e para o propósito deste tutorial só precisamos definir a configuração para começar a usar o recurso de website estático.

Criar um arquivo JSON com as informações de configuração apropriadas:

{
  "ErrorDocument": {
    "Key": "error.html"
  },
  "IndexDocument": {
    "Suffix": "index.html"
  }
}

Substitua o conteúdo do item temporário conforme mostrado no comando de exemplo para configurar o website:

ibmcloud cos bucket-website-put --bucket BUCKET_NAME --website-configuration file://<filename.json>

Você pode ter concluído essa etapa durante a criação de seu depósito, pois a configuração básica para seu website estático hospedado determina quando e como o conteúdo é mostrado.. Para os visitantes do seu website que não fornecem uma chave, ou página da web, o arquivo padrão será mostrado em vez disso. Quando seus usuários encontrarem um erro, a chave para a página de erro determinará qual conteúdo os visitantes receberão. As opções de configuração das páginas padrão e de erro são repetidas para referência.

http://<bucketname>.s3-web.<endpoint>/

Próximas etapas

A descrição detalhada das opções de configuração para websites estáticos hospedados do IBM Cloud Object Storage pode ser localizada na documentação da API.