# role

The create role command creates a new Role in the Kubernetes cluster. This command allows defining resource permissions and access levels for users or service accounts.

## Usage

```
cldkctl create role [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. You can create a Role either by opening the built-in editor or by using a YAML configuration file.
2. To open the editor, run:

```
cldkctl create role
```

3. The Role manifest will open in your default text editor (default: vim). Edit the configuration as needed, then save and close the file to apply the changes.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FNEn1e9cD8tvYhap2ukJk%2Funknown.png?alt=media&#x26;token=33534573-b6e8-4a73-be7d-805653b0fadb" alt=""><figcaption></figcaption></figure>

4. Alternatively, you can prepare a YAML file that defines the Role configuration, then save this file in the same directory where you will run the cldkctl command.
5. Use the --file flag to point to the YAML file.
6. (Optional) To specify a namespace or project, add the --default-namespace or --project flag.
7. Run the following command in your terminal:

```
cldkctl create role --file [role file name]
```

8. Replace \[role file name] with the path to your YAML configuration file.
9. Once completed successfully, a message “✓ Role created” will appear in your terminal.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FPdCJBdudbD7xaieAOq80%2Funknown.png?alt=media&#x26;token=bd6a7852-b1a2-480a-a0e3-437d3578269a" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports [global flags](https://docs.cloudeka.ai/cloudeka-api-list/global-flags). Refer to the Global Flags section for details.
{% endhint %}

| Flag       | Description                   |
| ---------- | ----------------------------- |
| -h, --help | Help for create role command. |

<br>
