symlink

This resource manages a symbolic link within the filesystem hierarchy of the client.

Relationship to other resources

The value of the path parameter must be unique among all symlink, file and directory resources.

A symlink implicitly depends on other symlinks or directory resources whose path parameters are ancestors to this symlink's path. For example when the path parameter of this symlink is set to /my/very/simple/example and there is a directory resource whose path is /my/very/simple, then the former implicitly depends on the latter.

If the target parameter of the symlink resource contains a path that matches the path parameters of a managed file or directory resource, the symlink resource depends on the latter.

Parameters

NameTypeDescriptionMandatoryDefault
ensurestringDetermines the desired state of the resource. One of present or absent.yespresent
pathstringPrimary parameter: An absolute filesystem path.yes
targetstringAn absolute filesystem path that the symlink should point to.yes

Examples

resources:
  - type: symlink
    parameters:
      path: /my/simple/example/link
	  target: /my/simple/target