Installation
_All the following notes assume you are at the command prompt for your chosen environment._
Confirm Node and YARN are installed and configured correctly, both the following commands should return the relevant version number.
> node –version > yarn –version
Clone the project from GitHub
Allow yarn to be able to include required SKAO libraries
> npm config set @ska-telescope:registry https://artefact.skao.int/repository/npm-internal/
Install all the necessary project dependencies by running
> yarn init
INstall required SKAO libraries
It is expected that required SKAO libraries would have been included at this point, however if this is found not to be the case, the following command will include them.
> yarn skao:update
### Steps to convert to your own application.
Here are the steps required to migrate this application for use within the Portal. These are required so that we can ensure a unique reference into the Portal. For this example we will use the name NewApp as the name of the new application
Clone the application into the appropriate folder
Follow the installation instructions in the previous paragraph
ReactSkeleton.tsx : Change ReactSkeleton to NewApp in 2 locations
ReactSkeleton.tsx : Change filename to `NewApp.tsx
ReactSkeleton.cy.tsx : Change ReactSkeleton to NewApp in 4 locations
ReactSkeleton.cy.tsx : Change filename to `NewApp.cy.tsx
Change Folder name from ReactSkeleton to NewApp
App.tsx : Change ReactSkeleton to NewApp in 4 locations
webPack.config.js : Change path for ReactSkeleton so it points to NewAppNewApp.
Compilation and running this application will allow it to be shown within the ReactSkeleton menu item within the developer section of the SKA-Portal. Whilst initial development is being done and until the application is allocated a permanent location, it is suggested that no other WebPack changes are done.
### Steps to create a new release
Note, this does not currently work in the Windows Shell. Use either Linux, Mac, or Windows WSL.
Also note that the chart names should be updated when you use a different repo name.
The following steps and commands is to create a new release for the portal.
Create a new branch from
main
branch.Run one of
make bump-major-release
,make bump-minor-release
, ormake bump-patch-release
Update the
charts/ska-react-webapp-skeleton/values.yaml
file, the image.version should be updated.Make sure the following files have the new version: *
charts/ska-react-webapp-skeleton/Chart.yaml
*package.json
*.release
Run
make git-create-tag
Run
make git-push-tag
You will then be able to merge that branch back in, and the new release should be created.