Page Comparison

...

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 Keep upstream and Make Editable 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 take it takes you back to the component card. The Connected To section will be updated with the new repository information.

Expand

title	STEP 2: Commit some code changes and push them to the remote repository

Now that there is a git repository tracking this component, changes made locally can be committed and saved to the cloud.

Click on Edit Script to open the Translator
Make some code changes. If nothing comes to mind, replace the code you see with the sample below, Now change the code to the following which just changes the component’s border on the dashboard to red:
Code Block
language lua
function main() component.setBorder{color="red"} end main()
Once you have made some changes, click on the Commit Changes button in the Translator toolbar, its the one that looks like a plus surrounded by a circle:
In the window that appears you can see the changes that were made. Enter a message that summarizes the changes, then click Commit
You will be sent back to the Translator screen. Notice that there are a few changes:
- The Push Changes button in the Translator toolbar which looks an arrow pointing to a cloud has a blue dot. This means a local change is ready to be pushed to the cloud repository.
- A new section has appeared at the bottom. This is the Git Terminal. This is where you will see information appear when Git commands like pulling, committing and pushing are done.
- Users familiar with how Git works can use this terminal to perform Git operations.
Click on the Push Changes button. If Git was able to successfully send your changes to the remote repository, you will see this:

...

Now your changes are on the remote repository, they are ready to be imported in to any other Iguana instances you have
Exit Translator by hitting the X in the top right corner of the Translator Window.

Expand

title	STEP 3: See the local code change in effect

The code change from the previous step was committed to the remote repository, but the component is not yet using the new code. The component must updated to use the new commit.

In the component card, use the Using Commit dropdown and change the commit the component is running on to the commit you made.
Image Added
Now close the card and run the component. You should see it get a red outline:
Image Added

Expand

title	STEP 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
Image Added
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
Image Added
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 Added
Now run the component and verify that the border turns green:
Image Added
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.
  Image Added

Expand

title	STEP 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
Image Added
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
Image Added
Once it is done, you will see this. Click Dismiss.
Image Added
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:
  Image Added
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:
  Image Added
- 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 Added
Now go back top the Dashboard and click + Component and you will see your component appear

Versions Compared

Old Version 5

New Version Current

Key