Guia de início rápido: acessar buckets do Cloud Storage com o driver CSI do FUSE

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the GKE and Cloud Storage APIs.

Enable the APIs

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the GKE and Cloud Storage APIs.

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.

      Acessar o IAM
   2. Selecione o projeto.
   3. Clique emperson_add Conceder acesso.

   4. No campo Novos principais, digite seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

   5. Na lista Selecionar papel, escolha um.
   6. Para conceder outros papéis, clique em add Adicionar outro papel e adicione cada papel adicional.
   7. Clique em Salvar.

   Criar um cluster do Autopilot do GKE

   1. No Google Cloud console, acesse a página Criar um cluster do Autopilot.

      Acessar "Criar um cluster do Autopilot"

   2. Em Princípios básicos do cluster, faça o seguinte:

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

      2. Mantenha os valores padrão das outras configurações.

   3. Para criar o cluster, clique em Criar.

   Criar um bucket do Cloud Storage

   1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
      

      Acessar buckets

   2. Clique em add_box Criar.

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

      1. Insira um nome globalmente exclusivo para o bucket que atenda aos requisitos de nomenclatura de bucket.

      2. Mantenha os valores padrão das outras configurações.

   4. Para criar o bucket, clique em Criar.

   Fazer upload de objetos para o bucket do Cloud Storage

   1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
      

      Acessar buckets

   2. Na lista de buckets, clique no nome do bucket que você acabou de criar.

   3. Na guia Objetos do bucket, faça o seguinte:

      • Arraste arquivos da área de trabalho ou do gerenciador de arquivos para o painel principal no console do Google Cloud .

      • Clique no botão Enviar arquivos. Na caixa de diálogo exibida, selecione os arquivos que você quer enviar e clique em Abrir.

   Configurar o acesso ao bucket do Cloud Storage

   Para garantir que o bucket do Cloud Storage esteja acessível pelo cluster do GKE, siga as etapas em Configurar o acesso a buckets do Cloud Storage.

   Implante um pod para acessar seu bucket do Cloud Storage usando o FUSE

   2. In the Google Cloud console, activate Cloud Shell.

      Activate Cloud Shell

      Uma sessão do Cloud Shell é aberta dentro de um frame no console.

   3. Para definir o projeto padrão, use o ID do projeto em que você quer implantar o pod:

      gcloud config set project PROJECT_ID
      

      Substitua PROJECT_ID pela ID do seu projeto.

   4. 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 seu bucket do Cloud Storage.
      • Se você estiver usando um namespace ou uma conta de serviço diferente, substitua os campos namespace e serviceAccountName de acordo com a situação.

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

   5. Verifique se ele está em execução:

      kubectl get pod gcsfuse-test
      

      O resultado será assim:

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

      O driver CSI do Cloud Storage FUSE anexa um contêiner secundário ao seu pod para gerenciar interações com o Cloud Storage.

      Se o pod não estiver em execução, busque os registros de eventos para ajudar a diagnosticar o problema executando o comando kubectl describe pod gcsfuse-test. Para mais informações, consulte Solução de problemas no GitHub.

   6. Depois que o pod estiver em execução, você poderá explorar o sistema de arquivos dele:

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

   Limpar

   Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial, exclua o pod:

   kubectl delete pod gcsfuse-test
   

   A seguir

   • Saiba como funciona o driver CSI do Cloud Storage FUSE para GKE.
   • Saiba mais sobre os recursos do Cloud Storage FUSE.
   • Resolver problemas do Cloud Storage FUSE .
   • Otimize o Cloud Storage FUSE para melhorar o desempenho.