Container Compute Service:Use a static OSS volume

Etapa 1: Criar um PV

1. Salve o conteúdo YAML a seguir como oss-pv.yaml.

   apiVersion: v1
   kind: Secret
   metadata:
     name: oss-secret
     namespace: default
   stringData:
     akId: <your AccessKey ID>
     akSecret: <your AccessKey Secret>
   ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: oss-pv
     labels:
       alicloud-pvname: oss-pv
   spec:
     storageClassName: test 
     capacity:
       storage: 20Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       volumeHandle: oss-pv
       nodePublishSecretRef:
         name: oss-secret
         namespace: default
       volumeAttributes:
         bucket: "<your OSS Bucket Name>"
         url: "<your OSS Bucket Endpoint>"
         otherOpts: "-o umask=022 -o allow_other"

   Nota

   Este YAML cria um Secret e um PV. O Secret armazena seu par de AccessKey, usado pelo PV para acesso seguro. Substitua os valores de akId e akSecret pelo seu AccessKey ID e AccessKey Secret reais.

   A tabela a seguir descreve os parâmetros do PV:

   Parâmetro	Descrição
   alicloud-pvname	Rótulo do PV, usado para vinculá-lo a um PVC.
   storageClassName	Este valor serve apenas para vinculação do PVC e não precisa corresponder a um objeto StorageClass existente.
   storage	Capacidade do volume do OSS. A capacidade especificada para um volume estático do OSS tem fins apenas declarativos. A capacidade real não é limitada, e a capacidade disponível baseia-se no uso exibido no console do OSS.
   accessModes	Modo de acesso. Valores válidos: ReadOnlyMany, que permite a vários pods montar o volume como somente leitura, e ReadWriteMany, que permite a vários pods montar o volume como leitura e gravação.
   persistentVolumeReclaimPolicy	Política de recuperação do PV.
   driver	Tipo de driver. Defina como ossplugin.csi.alibabacloud.com para usar o plugin Container Storage Interface (CSI) do Alibaba Cloud OSS.
   volumeHandle	UID (identificador único) do PV. Deve ser igual a metadata.name.
   nodePublishSecretRef	Referencia o Secret que contém o par de AccessKey para autorização.
   bucket	Nome do bucket do OSS. Substitua o valor de bucket pelo nome real do seu bucket do OSS.
   url	Endpoint do bucket do OSS. Substitua o valor de url pelo endpoint real do seu bucket do OSS. Se o bucket do OSS e o cluster ACS estiverem na mesma região, use o endpoint interno. Por exemplo, oss-cn-shanghai-internal.aliyuncs.com. Se o bucket do OSS for agnóstico em relação à região ou estiver em uma região diferente do cluster ACS, use o endpoint público. Por exemplo, oss-cn-shanghai.aliyuncs.com.
   otherOpts	Especifica opções personalizadas de montagem para o volume do OSS no formato -o -o . Por exemplo, -o umask=022 -o max_stat_cache_size=100000 -o allow_other. Expandir para ver detalhes umask: altera as permissões que o ossfs usa para ler arquivos. Por exemplo, umask=022 altera as permissões dos arquivos do ossfs para 755. Isso resolve permissões insuficientes dentro do ponto de montagem para objetos carregados por outros meios, como um SDK ou o console do OSS, que possuem permissões padrão de 640. (Recomendado) Defina esta opção para separação de leitura/gravação ou acesso multiusuário. max_stat_cache_size: define o número máximo de entradas no cache de metadados, como 100000. Armazenar metadados de objetos em memória melhora o desempenho de operações como ls e stat. No entanto, esse cache não detecta imediatamente alterações feitas pelo console do OSS, um SDK ou ossutil, então sua aplicação pode ler dados inconsistentes. Se você tiver requisitos rigorosos de consistência de dados, defina como 0 para desativar o cache ou use o parâmetro stat_cache_expire para reduzir o tempo de expiração do cache. Ambas as configurações reduzem o desempenho de leitura. allow_other: permite que usuários diferentes do usuário que realizou a montagem acessem os arquivos e diretórios no ponto de montagem. Use esta opção em ambientes compartilhados multiusuário onde outros usuários também precisam acessar os dados. Para mais configurações, consulte Mount options e Best practices.

2. Crie o Secret e o PV.

   kubectl create -f oss-pv.yaml

3. Visualize o PV.

   kubectl get pv

   Saída esperada:

   NAME     CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
   oss-pv   20Gi       RWX            Retain           Available           test           <unset>                          9s

Etapa 2: Criar um PVC

• Salve o conteúdo YAML a seguir como oss-pvc.yaml.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: oss-pvc
spec:
  storageClassName: test
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 20Gi
  selector:
    matchLabels:
      alicloud-pvname: oss-pv

A tabela a seguir descreve os parâmetros:

• Crie o PVC.

kubectl create -f oss-pvc.yaml

• Visualize o PVC.

kubectl get pvc

A saída esperada mostra que o PVC está vinculado ao PV criado na Etapa 1.

NAME      STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
oss-pvc   Bound    oss-pv   20Gi       RWX            test           <unset>                 6s

Etapa 3: Criar uma aplicação e montar o volume

• Crie um arquivo chamado oss-test.yaml com o seguinte conteúdo.

  O exemplo YAML a seguir cria um Deployment com dois pods. Ambos os pods solicitam armazenamento usando o PVC chamado oss-pvc, e o caminho de montagem para ambos é /data.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: oss-test
  labels:
    app: nginx
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
        ports:
        - containerPort: 80
        volumeMounts:
          - name: pvc-oss
            mountPath: /data
      volumes:
        - name: pvc-oss
          persistentVolumeClaim:
            claimName: oss-pvc

• Crie o Deployment e monte o volume do OSS.

kubectl create -f oss-test.yaml

• Verifique o status dos pods no Deployment.

kubectl get pod | grep oss-test

A saída de exemplo indica que dois pods foram criados.

oss-test-****-***a   1/1     Running   0          28s
oss-test-****-***b   1/1     Running   0          28s

• Verifique o caminho de montagem.

  O comando a seguir lista os dados no ponto de montagem do bucket do OSS. Por padrão, a saída é vazia.

kubectl exec oss-test-****-***a -- ls /data

Etapa 1: Criar um PV

1. Faça login no console do ACS.

2. Na página Clusters, clique no nome do cluster para acessar a página de gerenciamento do cluster.

3. No painel de navegação à esquerda da página de gerenciamento do cluster, escolha Volumes > Persistent Volumes.

4. Na página Persistent Volumes, clique em Create.

5. Na caixa de diálogo Create, configure os parâmetros e clique no botão Create.

   Parâmetro	Descrição	Exemplo
   PV Type	Tipo de volume. Selecione OSS.	OSS
   Volume Name:	Nome do PV. Especifique um nome personalizado de acordo com os requisitos de formatação exibidos na interface.	oss-pv
   Capacity	Capacidade do volume do OSS. A capacidade especificada para um volume estático do OSS tem fins apenas declarativos. A capacidade real não é limitada, e a capacidade disponível baseia-se no uso exibido no console do OSS.	20Gi
   Access Mode	Modo de acesso. Selecione uma opção conforme suas necessidades: ReadOnlyMany: O volume pode ser montado como somente leitura por vários pods. ReadWriteMany: O volume pode ser montado como leitura e gravação por vários pods.	ReadWriteMany
   Access Certificate	Para segurança, armazene as informações do AccessKey em um Secret. Este exemplo usa a opção Create Secret.	Create Secret namespace: default Name: oss-secret AccessKey ID: **** AccessKey Secret: ****
   Bucket ID:	Selecione um bucket do OSS.	oss-acs-***
   OSS Path	Diretório a ser montado. O padrão é o diretório raiz (/). Se você especificar um subdiretório, como /dir, certifique-se de que ele exista.	/
   Endpoint:	Endpoint do bucket do OSS. Se o bucket do OSS e o cluster ACS estiverem na mesma região, selecione a opção Internal Endpoint. Se o bucket do OSS for agnóstico em relação à região ou estiver em uma região diferente do cluster ACS, selecione a opção Public Endpoint.	Private Endpoint

   Após a criação do PV, visualize suas informações na página Persistent Volumes. O PV ainda não está vinculado a um PVC.

Etapa 2: Criar um PVC

1. No painel de navegação à esquerda da página de gerenciamento do cluster, escolha Volumes > Persistent Volume Claims.

2. Na página Persistent Volume Claims, clique em Create.

3. Na caixa de diálogo exibida, configure os parâmetros e clique no botão Create.

   Parâmetro	Descrição	Exemplo
   PVC Type	Tipo de volume. Selecione OSS.	OSS
   Name	Nome do PVC. Especifique um nome personalizado de acordo com os requisitos de formatação exibidos na interface.	oss-pvc
   Allocation Mode	Modo de alocação. Selecione a opção Existing Volumes.	Existing PV
   Existing Volumes	Selecione o PV que você criou.	oss-pv
   Capacity	Quantidade de armazenamento a ser solicitada. Este valor não pode exceder a capacidade do PV.	20Gi

   Após a criação do PVC, visualize-o na página Persistent Volume Claims. O PVC agora está vinculado ao PV (o volume do OSS).

Etapa 3: Criar uma aplicação e montar o volume

1. No painel de navegação à esquerda da página de gerenciamento do cluster, escolha Workloads > Deployments.

2. Na página Deployments, clique no botão Create from Image.

3. Configure os parâmetros do Deployment e clique no botão Create.

   A tabela a seguir descreve os principais parâmetros. Mantenha os valores padrão para os demais parâmetros. Para mais informações, consulte Create a Deployment.

   Seção	Parâmetro	Descrição	Exemplo
   Basic Information	Application Name	Nome do Deployment. Especifique um nome personalizado de acordo com os requisitos de formatação exibidos na interface.	oss-test
   Basic Information	Replicas:	Número de réplicas (pods) para o Deployment.	2
   Container	Image Name	Endereço da imagem usada para implantar a aplicação.	registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
   Container	Required Resources	Defina os recursos necessários de vCPU e memória.	0,25 vCPU, 0,5 GiB
   Volume	Add PVC	Clique no botão e configure os parâmetros: Mount Source: Selecione o PVC que você criou. Container Path: Insira o caminho do contêiner onde deseja montar o bucket do OSS.	Mount source: oss-pvc Container path: /data

4. Verifique o status do Deployment da aplicação.

   1. Na página Deployments, clique no nome da aplicação.

   2. Na aba Pods, certifique-se de que os pods estejam no estado Running.