55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
|
---
|
|||
|
|
layout: "ignition"
|
|||
|
|
page_title: "Ignition: ignition_user"
|
|||
|
|
sidebar_current: "docs-ignition-resource-user"
|
|||
|
|
description: |-
|
|||
|
|
Describes the desired user additions to the passwd database.
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# ignition\_user
|
|||
|
|
|
|||
|
|
Describes the desired user additions to the passwd database.
|
|||
|
|
|
|||
|
|
## Example Usage
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
resource "ignition_user" "foo" {
|
|||
|
|
name = "foo"
|
|||
|
|
home_dir = "/home/foo/"
|
|||
|
|
shell = "/bin/bash"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Argument Reference
|
|||
|
|
|
|||
|
|
The following arguments are supported:
|
|||
|
|
|
|||
|
|
* `name` - (Required) The username for the account.
|
|||
|
|
|
|||
|
|
* `password_hash` - (Optional) The encrypted password for the account.
|
|||
|
|
|
|||
|
|
* `ssh_authorized_keys` - (Optional) A list of SSH keys to be added to the user’s authorized_keys.
|
|||
|
|
|
|||
|
|
* `uid` - (Optional) The user ID of the new account.
|
|||
|
|
|
|||
|
|
* `gecos` - (Optional) The GECOS field of the new account.
|
|||
|
|
|
|||
|
|
* `home_dir` - (Optional) The home directory of the new account.
|
|||
|
|
|
|||
|
|
* `no_create_home` - (Optional) Whether or not to create the user’s home directory.
|
|||
|
|
|
|||
|
|
* `primary_group` - (Optional) The name or ID of the primary group of the new account.
|
|||
|
|
|
|||
|
|
* `groups` - (Optional) The list of supplementary groups of the new account.
|
|||
|
|
|
|||
|
|
* `no_user_group` - (Optional) Whether or not to create a group with the same name as the user.
|
|||
|
|
|
|||
|
|
* `no_log_init` - (Optional) Whether or not to add the user to the lastlog and faillog databases.
|
|||
|
|
|
|||
|
|
* `shell` - (Optional) The login shell of the new account.
|
|||
|
|
|
|||
|
|
## Attributes Reference
|
|||
|
|
|
|||
|
|
The following attributes are exported:
|
|||
|
|
|
|||
|
|
* `id` - ID used to reference this resource in _ignition_config_.
|