Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
title STEP 1: Change a template component’s repository
  • Anchor
    Set_up_component
    Set_up_component
    From the dashboard, click + Component and select Custom, name the component, then click Add.

  • Once the component appears on the dashboard, double click it to bring up its information.

  • In the Connected To section, click on Customize

  • Select Remove Upstream in the drop down list and click Confirm. The Connected To section should change to the following:

  • You now have two options:

    • Edit Script allows you to make code changes and run the component with those changes

    • Set Up allows you to set up a git repository for this component so that any changes made can be tracked

  • For now, click on Set Up to configure a repository for the component. You should see this window appear, with the Owner field being populated with the details of your Bitbucket account. If this is empty, follow this guide: Setting up Bitbucket Access

  • In the Repository field, pick a name for the repository such as my_first_component then click Confirm Change. This will create a new repository for you if a repository with that name doesn’t already exist.

  • The window will close itself, and it takes you back to the component card. The Connected To section will be updated with the new repository information.

...

Expand
titleSTEP 4: Clone in your component on a different Iguana and update the code

Since the changes made have been pushed to the cloud, this component can now be cloned into any other Iguana.

Note: To try out this step you need to have a different Iguana instance ready with Bitbucket access configured. See: Setting up Bitbucket Access

  • Open the component that was created. From the component card, copy the Connected To field

  • In a different Iguana instance, from the dashboard click + From Url. Give the component a name, and paste in the url from before then click Add

  • Once the component is created, click Edit Script to go to Translator

    • You may have to click and expand the Implementation section

  • See that the code changes made in the previous step have been brought across

  • Change to the code to the following, then commit and push the change.

    Code Block
    function main()
    	component.setBorder{color="green"}
    end
    main()
  • Back on your other Iguana instance, update the component to run from this new commit. It can take a minute or two for the new commits to show up.

    • Use the Using Commit dropdown and select the commit you just made:

      Image RemovedImage Added
  • Now run the component and verify that the border turns green:

  • Click on Edit Script to go to the Translator. To see the code changes, we have to pull in the changes from the remote repository.

    • Do this by clicking on the Pull Changes button which looks like a cloud with an arrow pointing away from it.

    • Notice that Pull Changes has a blue dot, indicating that there are changes available to be pulled in. Click Pull Changes and see that the code updates.

Expand
titleSTEP 5: Add the component to a collection

The process above outlined what it takes to create a component with some code that can be easily brought over to any number of Iguana instances. To make this process even easier, you can group components you make into a collection.

  • From the component card, click on Add to Collection, in the window that appears set the dropdown to +Create New Collection+ and click Select

  • Create a name for the collection, then click Create & Add. Wait for this to finish, and then in the window that appears click Select.

  • In the Edit collection screen that appears, create a name for your collection and click Save

  • Once it is done, you will see this. Click Dismiss.

  • Now go back to the dashboard and click + Component. You should see your component appear in the list of components available

    • Depending on the name you gave it, you may have to scroll through the list:

  • This collection has been added to the current Iguana instance. To see this, go to the Settings and click on Git Collection. Your newly created collection will appear in the repositories list.

    • To use this collection in a different Iguana instance, first copy the url:

    • Then in the other instance go to settings, click Git Collection and click Edit in the top right

    • Then click Add Collection and paste in the copied url and click Save

      Image RemovedImage Added
  • Now go back top the Dashboard and click + Component and you will see your component appear

...