github.com/1aal/kubeblocks@v0.0.0-20231107070852-e1c03e598921/docs/user_docs/cli/kbcli_fault_io_attribute.md (about)

     1  ---
     2  title: kbcli fault io attribute
     3  ---
     4  
     5  Override the attributes of the file.
     6  
     7  ```
     8  kbcli fault io attribute [flags]
     9  ```
    10  
    11  ### Examples
    12  
    13  ```
    14    # Affects the first container in default namespace's all pods. Delay all IO operations under the /data path by 10s.
    15    kbcli fault io latency --delay=10s --volume-path=/data
    16    
    17    # Affects the first container in mycluster-mysql-0 pod.
    18    kbcli fault io latency mycluster-mysql-0 --delay=10s --volume-path=/data
    19    
    20    # Affects the mysql container in mycluster-mysql-0 pod.
    21    kbcli fault io latency mycluster-mysql-0 --delay=10s --volume-path=/data -c=mysql
    22    
    23    # There is a 50% probability of affecting the read IO operation of the test.txt file under the /data path.
    24    kbcli fault io latency mycluster-mysql-0 --delay=10s --volume-path=/data --path=test.txt --percent=50 --method=READ -c=mysql
    25    
    26    # Same as above.Make all IO operations under the /data path return the specified error number 22 (Invalid argument).
    27    kbcli fault io errno --volume-path=/data --errno=22
    28    
    29    # Same as above.Modify the IO operation permission attribute of the files under the /data path to 72.(110 in octal).
    30    kbcli fault io attribute --volume-path=/data --perm=72
    31    
    32    # Modify all files so that random positions of 1's with a maximum length of 10 bytes will be replaced with 0's.
    33    kbcli fault io mistake --volume-path=/data --filling=zero --max-occurrences=10 --max-length=1
    34  ```
    35  
    36  ### Options
    37  
    38  ```
    39        --annotation stringToString      Select the pod to inject the fault according to Annotation. (default [])
    40        --blocks uint                    The number of blocks the file occupies.
    41    -c, --container stringArray          The name of the container, such as mysql, prometheus.If it's empty, the first container will be injected.
    42        --dry-run string[="unchanged"]   Must be "client", or "server". If with client strategy, only print the object that would be sent, and no data is actually sent. If with server strategy, submit the server-side request, but no data is persistent. (default "none")
    43        --duration string                Supported formats of the duration are: ms / s / m / h. (default "10s")
    44        --gid uint32                     The owner's group ID.
    45    -h, --help                           help for attribute
    46        --ino uint                       ino number.
    47        --label stringToString           label for pod, such as '"app.kubernetes.io/component=mysql, statefulset.kubernetes.io/pod-name=mycluster-mysql-0. (default [])
    48        --method stringArray             The file system calls that need to inject faults. For example: WRITE READ
    49        --mode string                    You can select "one", "all", "fixed", "fixed-percent", "random-max-percent", Specify the experimental mode, that is, which Pods to experiment with. (default "all")
    50        --nlink uint32                   The number of hard links.
    51        --node stringArray               Inject faults into pods in the specified node.
    52        --node-label stringToString      label for node, such as '"kubernetes.io/arch=arm64,kubernetes.io/hostname=minikube-m03,kubernetes.io/os=linux. (default [])
    53        --ns-fault stringArray           Specifies the namespace into which you want to inject faults. (default [default])
    54    -o, --output format                  Prints the output in the specified format. Allowed values: JSON and YAML (default yaml)
    55        --path string                    The effective scope of the injection error can be a wildcard or a single file.
    56        --percent int                    Probability of failure per operation, in %. (default 100)
    57        --perm uint16                    Decimal representation of file permissions.
    58        --phase stringArray              Specify the pod that injects the fault by the state of the pod.
    59        --size uint                      File size.
    60        --uid uint32                     Owner's user ID.
    61        --value string                   If you choose mode=fixed or fixed-percent or random-max-percent, you can enter a value to specify the number or percentage of pods you want to inject.
    62        --volume-path string             The mount point of the volume in the target container must be the root directory of the mount.
    63  ```
    64  
    65  ### Options inherited from parent commands
    66  
    67  ```
    68        --as string                      Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
    69        --as-group stringArray           Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
    70        --as-uid string                  UID to impersonate for the operation.
    71        --cache-dir string               Default cache directory (default "$HOME/.kube/cache")
    72        --certificate-authority string   Path to a cert file for the certificate authority
    73        --client-certificate string      Path to a client certificate file for TLS
    74        --client-key string              Path to a client key file for TLS
    75        --cluster string                 The name of the kubeconfig cluster to use
    76        --context string                 The name of the kubeconfig context to use
    77        --disable-compression            If true, opt-out of response compression for all requests to the server
    78        --insecure-skip-tls-verify       If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
    79        --kubeconfig string              Path to the kubeconfig file to use for CLI requests.
    80        --match-server-version           Require server version to match client version
    81    -n, --namespace string               If present, the namespace scope for this CLI request
    82        --request-timeout string         The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
    83    -s, --server string                  The address and port of the Kubernetes API server
    84        --tls-server-name string         Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
    85        --token string                   Bearer token for authentication to the API server
    86        --user string                    The name of the kubeconfig user to use
    87  ```
    88  
    89  ### SEE ALSO
    90  
    91  * [kbcli fault io](kbcli_fault_io.md)	 - IO chaos.
    92  
    93  #### Go Back to [CLI Overview](cli.md) Homepage.
    94