Início rápido: aceda a contentores do Cloud Storage com o controlador CSI do FUSE

Início rápido: aceda a contentores do Cloud Storage com o controlador CSI do FUSE

Autopilot

Neste guia de início rápido, vai saber como aceder a contentores do Cloud Storage a partir de uma aplicação do Google Kubernetes Engine (GKE) como se fossem sistemas de ficheiros locais. Este início rápido fornece um manifesto do Kubernetes de exemplo para criar um pod que monta o contentor e mostra como interagir com o conteúdo do contentor através do sistema de ficheiros do pod.

Esta página destina-se a programadores, especialistas em armazenamento e qualquer outra pessoa que queira aprovisionar e gerir recursos na nuvem, e implementar cargas de trabalho. Para saber mais sobre as funções comuns, consulte o artigo Funções e tarefas comuns de utilizadores do GKE.

Antes de ler esta página, certifique-se de que conhece o Kubernetes e o controlador CSI do FUSE do Cloud Storage.

Este início rápido usa o modo GKE Autopilot. Se quiser usar o modo padrão, consulte o artigo Configure o controlador CSI FUSE do Cloud Storage para o GKE.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the GKE and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the GKE and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. Make sure that you have the following role or roles on the project: Kubernetes Engine Admin, Storage Admin, Service Account User

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      Aceder ao IAM
   2. Selecione o projeto.
   3. Clique em Conceder acesso.

   4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

   5. Na lista Selecionar uma função, selecione uma função.
   6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
   7. Clique em Guardar.

   Crie um cluster do GKE Autopilot

   1. Na Google Cloud consola, aceda à página Criar um cluster do Autopilot.

      Aceda a Crie um cluster do Autopilot

   2. Em Noções básicas de cluster, faça o seguinte:

      1. No campo Nome, introduza um nome para o cluster.

      2. Mantenha os valores predefinidos para as restantes definições.

   3. Para criar o cluster, clique em Criar.

   Crie um contentor do Cloud Storage

   1. Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
      

      Aceda a Recipientes

   2. Clique em Criar.

   3. Na página Criar um contentor, na secção Começar, faça o seguinte:

      1. Introduza um nome globalmente exclusivo para o seu contentor que cumpra os requisitos de nomenclatura de contentores.

      2. Mantenha os valores predefinidos para as restantes definições.

   4. Para criar o contentor, clique em Criar.

   Carregue objetos para o seu contentor do Cloud Storage

   1. Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
      

      Aceda a Recipientes

   2. Na lista de contentores, clique no nome do contentor que acabou de criar.

   3. No separador Objetos do contentor, faça uma das seguintes ações:

      • Arraste ficheiros do ambiente de trabalho ou do gestor de ficheiros para o painel principal na consola Google Cloud .

      • Clique no botão Carregar ficheiros. Na caixa de diálogo apresentada, selecione os ficheiros que quer carregar e clique em Abrir.

      Nota: se estiver a usar o navegador Chrome, os carregamentos de pastas também são suportados.

   Configure o acesso ao seu contentor do Cloud Storage

   Para se certificar de que o seu contentor do Cloud Storage está acessível ao cluster do GKE, siga os passos em Configure o acesso a contentores do Cloud Storage.

   Configure o Cloud Shell

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   É iniciada uma sessão do Cloud Shell e é apresentado um pedido de linha de comandos. A sessão pode demorar alguns segundos a ser inicializada.

   Implemente um pod para aceder ao seu contentor do Cloud Storage através do FUSE

   Nota: para otimizar a sua configuração, consulte o artigo Otimize o controlador CSI do FUSE do Cloud Storage para o desempenho do GKE.

   1. Defina o projeto predefinido onde quer implementar o pod:

      gcloud config set project PROJECT_ID
      

      Substitua PROJECT_ID pelo ID do seu projeto.

   2. Crie e aplique o manifesto do pod com o seguinte conteúdo:

      cat << EOF | kubectl apply -f -
      apiVersion: v1
      kind: Pod
      metadata:
        name: gcsfuse-test
        namespace: default
        annotations:
          gke-gcsfuse/volumes: "true"
      spec:
        terminationGracePeriodSeconds: 60
        containers:
        - image: busybox
          name: busybox
          command: ["sleep"]
          args: ["infinity"]
          volumeMounts:
          - name: gcsfuse-test
            mountPath: /data
            readOnly: true
        serviceAccountName: default
        volumes:
        - name: gcsfuse-test
          csi:
            driver: gcsfuse.csi.storage.gke.io
            volumeAttributes:
              bucketName: BUCKET_NAME
              mountOptions: "implicit-dirs"
      EOF
      

      • Substitua BUCKET_NAME pelo nome do contentor do Cloud Storage.
      • Se estiver a usar um espaço de nomes diferente ou uma conta de serviço, substitua os campos namespace e serviceAccountName em conformidade.

      O conteúdo deste manifesto inicia um pod denominado gcsfuse-test que monta o contentor no respetivo caminho /data.

   3. Verifique se o Pod está em execução:

      kubectl get pod gcsfuse-test
      

      O resultado é semelhante ao seguinte:

      NAME           READY   STATUS    RESTARTS   AGE
      gcsfuse-test   2/2     Running   0          12s
      

      O controlador CSI FUSE do Cloud Storage associa um contentor sidecar no seu pod para gerir as interações com o Cloud Storage.

      Se o Pod não estiver em execução, pode obter os registos de eventos para ajudar a diagnosticar o problema executando o comando kubectl describe pod gcsfuse-test. Para mais informações, consulte a secção Resolução de problemas no GitHub.

   4. Depois de o Pod estar em execução, pode explorar o respetivo sistema de ficheiros:

      kubectl exec -it gcsfuse-test -- find /data
      

      Êxito: acedeu com êxito ao seu contentor do Cloud Storage como um sistema de ficheiros local!

   Limpar

   Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos que usou neste tutorial, elimine o pod:

   kubectl delete pod gcsfuse-test
   

   O que se segue?

   • Saiba como funciona o controlador CSI FUSE do Cloud Storage para o GKE.
   • Saiba mais sobre as capacidades do Cloud Storage FUSE.
   • Resolva problemas do FUSE do Cloud Storage .
   • Otimize o FUSE do Cloud Storage para o desempenho.