You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: using-tasks.html.md.erb
+16-11Lines changed: 16 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -31,18 +31,22 @@ Tasks are used to perform one-off jobs. For example, you can use a task to:
31
31
32
32
###<aid="task-proceses"></a> How Tasks Are Run
33
33
34
-
* A task includes the command to start the process, disk size, and memory allocation
35
-
* A task inherits environment variables, service bindings and security groups bound to the application
36
-
* Tasks respect app, space, and organization level memory quotas
37
-
* Tasks have a memory limit and a disk limit (global cloud foundry defaults for app memory in your bosh manifest or in ERT Application Developer Controls)
38
-
39
34
The life-cycle of a task is:
40
35
41
-
1. A user initiates a task using the `cf run-task APPNAME TASK` command.
36
+
1. A user initiates a task in Cloud Foundry. A user can initiate a task in CF by using one of the following mechanisms:
37
+
* `cf run-task APPNAME TASK` command
38
+
* Cloud Controler v3 API call. See the [Tasks](http://v3-apidocs.cloudfoundry.org/version/3.0.0/index.html#tasks) API reference page.
39
+
* Cloud Foundry Java Client. See
40
+
42
41
1. Cloud Foundry creates container specifically for the task.
43
42
1. Cloud Foundry runs the task on the container using the value provided to the `cf run-task` command
44
43
1. Cloud Foundry destroys container
45
44
45
+
* A task includes the command to start the process, disk size, and memory allocation
46
+
* A task inherits environment variables, service bindings and security groups bound to the application
47
+
* Tasks respect app, space, and organization level memory quotas
48
+
* Tasks have a memory limit and a disk limit (global cloud foundry defaults for app memory in your bosh manifest or in ERT Application Developer Controls)
49
+
* Tasks are always executed asynchronously
46
50
47
51
<pclass="note"><strong>Note</strong>: You cannot SSH into a running task.</p>
48
52
@@ -52,8 +56,6 @@ The life-cycle of a task is:
52
56
* A syslog drain attached to an app will receive task log output
53
57
* Stdout/stderr from the task will be available on the app’s firehose logs
54
58
55
-
56
-
57
59
## <aid='run-task'></a> Managing Tasks
58
60
59
61
* Admins can use the CAPI API to view all the tasks that are running in and org or space. (link to API docs)
@@ -65,13 +67,16 @@ Tasks have the following states:
65
67
* FAILED: the task did not complete. This state occurs when a task does not work correctly or a user cancels the task.
66
68
* SUCCEEDED: the task completed successfully.
67
69
70
+
* To re-execute a task, you must create it as a new task.
71
+
* A task is cancellable
72
+
73
+
### CF CLI Support
68
74
69
75
You can use the cf CLI to run a task in the context of an application.
70
76
71
-
* To re-execute a task, you must create it as a new task.
72
-
* A task is cancellable
73
77
74
-
* Tasks are always executed asynchronously
78
+
79
+
75
80
76
81
To support running and managing tasks, the cf CLI supports the following commands:
0 commit comments