CodeScene: Technical Debt Management and Code Quality Analytics Tool

Check out our Getting Started documentation: https://docs.enterprise.codescene.io/latest/getting-started/aws-marketplace.html 

This product requires an Internet connection to deploy and perform subsequent updates of the product. The following packages are downloaded on deployment:

• docker-compose binary: https://github.com/docker/compose/releases/ 
• codescene docker image: https://hub.docker.com/r/codescene/codescene 

This product also requires an ongoing Internet connection. The following external services are required to properly function:

• https://portal.codescene.com/ 

This product is accessible only via HTTPS - you MUST set the "CertificateARN" parameter for this to work. The certificate must be created separately by your infrastructure team - see aws docs for more details: https://docs.aws.amazon.com/acm/latest/userguide/gs.html 

The "IngressIP" template parameter specifies the source IP range allowed to access the deployed application. It should be specified according to your network security policies. Note that "PR Integration" (https://docs.enterprise.codescene.io/latest/integrations/pr-integration/integrate-into-ci-cd.html ), requires an open network route from your Git provider (such as GitHub, BitBucket, GitLab, or Azure DevOps) to the CodeScene app to receive PR webhooks events. If you have an on-premise installation of a Git provider (such as GitHub Enterprise) you can restrict the incoming traffic to your IP ranges. If you use a publicly hosted Git provider (such as github.com) you need to either allow all traffic with "0.0.0.0/0" (less secure) or periodically update the load balancer's security group based on the provider's published IP ranges (e.g. https://api.github.com/meta ).

An IAM role (CodeSceneEC2Role) is created during deployment. This role gives the CodeScene instance necessary permissions for communicating with AWS License Manager (to fetch Contract license info), to deliver logs to CloudWatch, and for secure connections to the instance via Session Manager (SSM).

After the CloudFormation stack is deployed, access the CodeScene web UI via a custom hostname/domain (that you created and associated with the load balancer (ALB)), If you don't have a custom domain, use the ALB's domain - to find it, go to the 'Resources' tab in the CloudFormation stack details, open the link in the "Physical ID" column of the "ApplicationLoadBalancer" resource, and copy "DNS name".

To log in for the first time, use the default admin account: 'aws.marketplace' username and the ec2 instance id as the password.

After you log in, use the web UI hostname as "CodeScene Host URL" in Configuration -> System -> Host/Network Settings. Also, consider removing the default login message in Configuration -> License. Finally, we recommend creating your own admin user in Configuration -> Authentication and deleting the default 'aws.marketplace' user.

To update the CodeScene app to the latest codescene (image) version, connect to the instance and run /home/ec2-user/codescene/codescene.sh update. To connect to the instance, open the AWS console -> EC2 -> right-click on the codescene instance -> Connect -> Session Manager -> Connect (make sure the username is ec2-user).