From 8c55ab8d0f6fcec9a8e6d2eb9375c000c82e1665 Mon Sep 17 00:00:00 2001 From: amiyakumar-sahoo Date: Mon, 27 Jan 2025 19:34:55 +0530 Subject: [PATCH 1/2] updated --- .idea/.gitignore | 3 ++ .idea/misc.xml | 6 +++ .idea/modules.xml | 8 ++++ .idea/plugin-docs-terraform-iaac.iml | 9 ++++ .idea/vcs.xml | 6 +++ docs/downloads.md | 12 ----- docs/index.md | 25 ++--------- docs/steps.md | 16 +++---- docs/usage.md | 66 ---------------------------- 9 files changed, 43 insertions(+), 108 deletions(-) create mode 100644 .idea/.gitignore create mode 100644 .idea/misc.xml create mode 100644 .idea/modules.xml create mode 100644 .idea/plugin-docs-terraform-iaac.iml create mode 100644 .idea/vcs.xml diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..26d3352 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,3 @@ +# Default ignored files +/shelf/ +/workspace.xml diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..07115cd --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml new file mode 100644 index 0000000..2bf425c --- /dev/null +++ b/.idea/modules.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/plugin-docs-terraform-iaac.iml b/.idea/plugin-docs-terraform-iaac.iml new file mode 100644 index 0000000..d6ebd48 --- /dev/null +++ b/.idea/plugin-docs-terraform-iaac.iml @@ -0,0 +1,9 @@ + + + + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..35eb1dd --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/docs/downloads.md b/docs/downloads.md index 77032c3..b87ca8b 100644 --- a/docs/downloads.md +++ b/docs/downloads.md @@ -2,15 +2,3 @@ --- -- [ucd-plugins-zos-rexx-2.1168947.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1168947.zip) -- [ucd-plugins-zos-rexx-2.1168604.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1168604.zip) -- [ucd-plugins-zos-rexx-2.1164401.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1164401.zip) -- [ucd-plugins-zos-rexx-2.1164307.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1164307.zip) -- [ucd-plugins-zos-rexx-2.1161998.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1161998.zip) -- [ucd-plugins-zos-rexx-2.1161121.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1161121.zip) -- [ucd-plugins-zos-rexx-2.1161042.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1161042.zip) -- [ucd-plugins-zos-rexx-2.1159387.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1159387.zip) -- [ucd-plugins-zos-rexx-2.1158244.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1158244.zip) -- [ucd-plugins-zos-rexx-2.1154680.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1154680.zip) -- [ucd-plugins-zos-rexx-1.1152822.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-1.1152822.zip) - diff --git a/docs/index.md b/docs/index.md index 128d2f4..4fb8677 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,22 +2,18 @@ --- -The zOS Rexx Executor can run REXX statements provided in a dataset or in the plugin step. - -Apart from executing a REXX program, this plug-in provides ability to create output properties. +The Terraform Plugin can be used to create AWS cloud infrastructures like EC2 instances. ## Compatibility The plug-in is compatible with: * UrbanCode Deploy version 7.0.0 or later -* UrbanCode Deploy agents on z/OS -* IBM z/OS version 2.1 or later * IBM Java 8 or 11 ## Available Steps -* Execute a REXX program +* Run Terraform Command (AWS). ## Installation @@ -25,20 +21,7 @@ No special steps are required for installation. See [Installing plug-ins in Urba ## History -### Version 2 - -* Added new checkbox input to show debug logs in case of any unknown failure. -* Output will now show the elapsed time of the REXX program -* New output property RexxReturnCode will store the return code of the REXX program -* Fixes output buffer issue when output has too much data -* Arguments can now be as big as 248 characters -* Fixed issue with work directory during two or more parallel step execution -* Minor improvements in temporary directory creation -* Fixed handling of CLIST error message response from ISPF Gateway -* Changes to run process in Legacy ISPF Gateway -* Improvements in ISPF gateway error handling -* Fixed PH62152 - RcException while allocating temporary datasets -### Version 1 +### Version 0.1 -* Initial release \ No newline at end of file +* Initial release of the new Tearraform Plugin \ No newline at end of file diff --git a/docs/steps.md b/docs/steps.md index e7c746c..4cb9095 100644 --- a/docs/steps.md +++ b/docs/steps.md @@ -2,16 +2,14 @@ --- -## Process steps in the z/OS Rexx Executor plug-in +## Process steps in the Terraform-IAAC plug-in -### Execute a REXX program +### Run Terraform Command (AWS) Use this step to execute rexx program -| Name | Type | Description | Required | -|------------------|-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------| -| Source Type | Enumeration: INLINE / DATASET | Source of REXX program | Yes | -| Source Value | String | Text or PDS member or Sequential Dataset that has REXX program. If the single quotation marks are omitted, the user's data set prefix from the TSO profile is prefixed to the front of the data set name. | Yes | -| Arguments | String | Specify the arguments(without quotes) to the REXX program | No | -| SYSPROC Datasets | String | Specify fully qualified SYSPROC datasets that the INPUT REXX program may use | No | - +| Name | Type | Description | Required | +|----------------------|--------|------------------------------------------------------------------------------------------------------------------------------|----------| +| Terraform File Path | String | Full path of the .tf file that contains all configurations needed for a resource creation for any cloud service provider. | Yes | +| Source Value | String | Full path of the terraform installation. Ex: /usr/local/bin/. | Yes | +| AWS Role | String | AWS Role to assume | No | diff --git a/docs/usage.md b/docs/usage.md index 1aae63c..129a269 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -2,69 +2,3 @@ --- -The z/OS Rexx Executor plug-in will execute statements provided in a dataset or inline in the plugin step. - -Select **Source type** as **DATASET** from the drop-down and -enter the dataset in the **Source Value**. -Fully qualified dataset needs to be enclosed in single quotes. -When the quotes are omitted then, the TSO prefix of the id running the -plugin step is prefixed to the Source Dataset. - -(or) - -Select **Source type** as **INLINE** from the drop-down and -then in the **Source Value** enter REXX statements beginning with a **/\* REXX \*/** statement. - -Arguments can be passed to the REXX program with/without quotes. -However, if there are more than one argument then arguments must be separated by a space. - -The **SYSPROC** field allows user to pass datasets containing REXX programs -that will be used by the REXX program run by the plugin step. -Multiple **SYSPROC** datasets can be passed by separating datasets by a comma(,). - -### Setting output property - -This plugin allows user to set output properties from the REXX program and -later to be used in successive steps of a process. -A user REXX program can simply invoke a call to **SETPROP** with two arguments. - -The first argument is output property name and -the second argument is the property value. - -> CALL SETPROP propertyName propertyValue - -For example, below REXX snippet will set an output property **currentDate** with value of **date** variable - -*** - /* REXX */ - date = DATE('S') /* Returns date in YYYYMMDD format E.g., 20120327 */ - CALL SETPROP "currentDate" date - -### Setting multi-line output property - -To set a multi-line output property, the lines of the property value must be separated -by a delimiter returned by inbuilt program **GETDLMTR** - -*** - /* REXX */ - delimiter = GETDLMTR() /* Return delimiter to separate lines */ - lines = "This is first line" || delimiter || "This is second line" - CALL SETPROP "outputLines" lines - -Will set property **outputLines** to below value - -*** - This is first line - This is second line - -### Referring properties from successive steps - -If the rexx step name is **Run-Rexx-Program** and output property name is **currentDate** -then the output properties can be referred by the successive steps as below - -> ${p:Run-Rexx-Program/currentDate} - -**Note** - -From plugin version 2, an output property __RexxReturnCode__ will store the return/exit code from REXX program. - From 68a3d56d68e3dae1fd81acddd42ff4b7b2220ba0 Mon Sep 17 00:00:00 2001 From: Amiya-873 <71648041+Amiya-873@users.noreply.github.com> Date: Mon, 27 Jan 2025 19:36:32 +0530 Subject: [PATCH 2/2] Delete .idea directory --- .idea/.gitignore | 3 --- .idea/misc.xml | 6 ------ .idea/modules.xml | 8 -------- .idea/plugin-docs-terraform-iaac.iml | 9 --------- .idea/vcs.xml | 6 ------ 5 files changed, 32 deletions(-) delete mode 100644 .idea/.gitignore delete mode 100644 .idea/misc.xml delete mode 100644 .idea/modules.xml delete mode 100644 .idea/plugin-docs-terraform-iaac.iml delete mode 100644 .idea/vcs.xml diff --git a/.idea/.gitignore b/.idea/.gitignore deleted file mode 100644 index 26d3352..0000000 --- a/.idea/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -# Default ignored files -/shelf/ -/workspace.xml diff --git a/.idea/misc.xml b/.idea/misc.xml deleted file mode 100644 index 07115cd..0000000 --- a/.idea/misc.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml deleted file mode 100644 index 2bf425c..0000000 --- a/.idea/modules.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/.idea/plugin-docs-terraform-iaac.iml b/.idea/plugin-docs-terraform-iaac.iml deleted file mode 100644 index d6ebd48..0000000 --- a/.idea/plugin-docs-terraform-iaac.iml +++ /dev/null @@ -1,9 +0,0 @@ - - - - - - - - - \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml deleted file mode 100644 index 35eb1dd..0000000 --- a/.idea/vcs.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file