Ayuda de la línea de comandos de AMC - Container Service for Kubernetes

AMC es la herramienta de línea de comandos para ACK One Fleet. Este tema abarca la descarga e instalación, las funciones principales y cómo obtener ayuda desde la línea de comandos.

AMC es un complemento de kubectl para Distributed Cloud Container Platform for Kubernetes (ACK One). Con AMC, usted puede:

Usar AMC igual que kubectl
Gestionar Deployments, Services e Ingresses en los clústeres administrados por Fleet
Consultar el estado de los recursos de Kubernetes (Pods, Services) en uno o en todos los clústeres administrados
Consulte los registros de tareas de las cargas de trabajo programadas en un clúster administrado
Inspeccionar la topología de aplicaciones y el estado de los recursos entre clústeres

Requisitos previos

Asegúrese de contar con lo siguiente:

Una instancia de ACK One Fleet con como mínimo un clúster asociado
El archivo kubeconfig de la instancia de Fleet
wget (Linux) o curl (macOS) instalado

Instalar AMC

Descargue el binario de AMC, otórguele permisos de ejecución y muévalo a /usr/local/bin.

Linux

Arquitectura	Comando
amd64	`wget http://ack-one.oss-cn-hangzhou.aliyuncs.com/kubectl-amc-linux-amd64 && chmod +x kubectl-amc-linux-amd64 && mv kubectl-amc-linux-amd64 /usr/local/bin/kubectl-amc`
arm64	`wget http://ack-one.oss-cn-hangzhou.aliyuncs.com/kubectl-amc-linux-arm64 && chmod +x kubectl-amc-linux-arm64 && mv kubectl-amc-linux-arm64 /usr/local/bin/kubectl-amc`

macOS

Arquitectura	Comando
amd64	`curl -LO http://ack-one.oss-cn-hangzhou.aliyuncs.com/kubectl-amc-mac-amd64 && chmod +x kubectl-amc-mac-amd64 && mv kubectl-amc-mac-amd64 /usr/local/bin/kubectl-amc`
arm64	`curl -LO http://ack-one.oss-cn-hangzhou.aliyuncs.com/kubectl-amc-mac-arm64 && chmod +x kubectl-amc-mac-arm64 && mv kubectl-amc-mac-arm64 /usr/local/bin/kubectl-amc`

Comprobar la instalación

Ejecute kubectl amc -h para comprobar que AMC se instaló correctamente:

kubectl amc -h

Listar los clústeres administrados y sus alias

Ejecute kubectl amc get managedcluster para listar todos los clústeres y sus alias:

kubectl amc get managedcluster

Salida esperada:

Name                  Alias       HubAccepted
managedcluster-c****   cluster1    true
managedcluster-c****   cluster2    true
managedcluster-c****   cluster3    true

Nota

Los clústeres asociados previamente con ACK One muestran none en la columna Alias.

Establecer un alias de clúster

Para establecer un alias de clúster:

kubectl annotate managedcluster <managedcluster name> ackone.aliyun.com/cluster-alias=<cluster-alias>

Para actualizar un alias, agregue --overwrite:

kubectl annotate managedcluster <managedcluster name> ackone.aliyun.com/cluster-alias=<cluster-alias> --overwrite

Consultar recursos en un clúster administrado

Use -m para apuntar a un clúster específico, o bien -m all para consultar todos los clústeres.

Bandera	Descripción
`-n <namespace>`	Namespace que se va a consultar
`-m <cluster-name>`	Nombre del clúster administrado. Use `all` para incluir todos los clústeres.

Consultar un clúster específico

kubectl amc get deployment -n demo -m managedcluster-c****

Reemplace managedcluster-c**** con el nombre de su clúster.

Salida esperada:

Run on ManagedCluster managedcluster-c**** (cluster-alias-****)
NAME       READY   UP-TO-DATE   AVAILABLE   AGE
web-demo   1/1     1            1           42h

Consultar todos los clústeres

kubectl amc get deployment -n demo -m all

Salida esperada:

Run on ManagedCluster managedcluster-c**** (cluster1)
NAME       READY   UP-TO-DATE   AVAILABLE   AGE
web-demo   1/1     1            1           42h
Run on ManagedCluster managedcluster-c**** (cluster2)
NAME       READY   UP-TO-DATE   AVAILABLE   AGE
web-demo   3/3     3            3           42h
Run on ManagedCluster managedcluster-c**** (cluster3)
NAME       READY   UP-TO-DATE   AVAILABLE   AGE
web-demo   5/5     5            5           42h

Inspeccionar la topología de una aplicación

Use appstatus junto con --tree y --detail para mostrar la topología de una aplicación y el estado de sus recursos entre clústeres.

Bandera	Descripción
`--tree`	Muestra los recursos en forma de árbol con sus relaciones jerárquicas
`--detail`	Muestra el estado detallado de cada recurso

kubectl amc appstatus demo -n demo --tree --detail

Salida esperada:

CLUSTER                                              NAMESPACE     RESOURCE        STATUS    APPLY_TIME          DETAIL
managedcluster-c****─── demo   ─┬─ Deployment/demo updated   2022-05-27 06:48:13 Ready: 4/4  Up-to-date: 4  Available: 4  Age: 8m2s
                               ├─ Ingress/demo    updated   2022-05-27 06:48:13 Class: <none>  Hosts: app.demo.example.com  Address:
                               │                                                 Ports: 80  Age: 8m2s
                               ├─ ConfigMap/demo  updated   2022-05-27 14:48:13 Data: 4  Age: 8m2s
                               └─ Service/demo    updated   2022-05-27 06:48:13 Type: ClusterIP  Cluster-IP: 192.168.9.178
                                                                                                                 External-IP: <none>  Port(s): 82/TCP  Age: 8m2s
managedcluster-c****─── demo   ─┬─ Deployment/demo updated   2022-05-27 06:48:16 Ready: 2/2  Up-to-date: 2  Available: 2  Age: 7m59s
                               ├─ Ingress/demo    updated   2022-05-27 06:48:15 Class: <none>  Hosts: app.demo.example.com  Address:
                               │                                                 Ports: 80  Age: 7m59s
                               ├─ ConfigMap/demo  updated   2022-05-27 14:48:17 Data: 4  Age: 7m58s
                               └─ Service/demo    updated   2022-05-27 06:48:15 Type: ClusterIP  Cluster-IP: 192.168.199.111
                                                                                                                 External-IP: <none>  Port(s): 82/TCP  Age: 7m59s