Skip to content

43-ndx-try-aws-isb.md

Latest commit

 

History

History
137 lines (98 loc) · 6.35 KB

43-ndx-try-aws-isb.md

File metadata and controls

137 lines (98 loc) · 6.35 KB

NDX Try AWS ISB Repository

Last Updated: 2026-03-02 Source: https://github.com/co-cddo/ndx-try-aws-isb Captured SHA: 70bb7ec

Executive Summary

The ndx-try-aws-isb repository is an empty placeholder containing only a .gitignore file and an MIT license. Despite its name suggesting it would house Innovation Sandbox (ISB) configuration or customization for the NDX:Try platform, the repository has never been populated with source code, infrastructure definitions, or documentation. The actual ISB implementation resides in the innovation-sandbox-on-aws repository (upstream AWS solution fork) and its satellite repositories, while AWS organizational configuration is managed by ndx-try-aws-lza and ndx-try-aws-terraform.

Repository Contents

The repository contains exactly two files beyond the .git/ directory:

ndx-try-aws-isb/
  .git/            # Git repository metadata
  .gitignore       # Standard Node.js .gitignore file
  LICENSE          # MIT License, Copyright (c) 2025 Central Digital and Data Office

There is no source code, no infrastructure-as-code definitions, no configuration files, no GitHub Actions workflows, and no documentation.

Intended Purpose Analysis

Based on naming conventions and cross-references across the NDX:Try ecosystem, this repository was likely intended to serve one or more of the following purposes:

graph TB
    subgraph "What ndx-try-aws-isb Could Have Been"
        OPT1["ISB Configuration Overrides<br/>Custom CDK context,<br/>environment variables,<br/>deployment parameters"]
        OPT2["ISB Deployment Scripts<br/>Automation for deploying<br/>ISB to the NDX AWS org"]
        OPT3["ISB Customization Layer<br/>NDX-specific modifications<br/>on top of upstream ISB"]
    end

    subgraph "What Actually Exists"
        ISB_CORE["innovation-sandbox-on-aws<br/><b>Actual ISB Core</b><br/>Full CDK/CloudFormation solution"]
        ISB_SAT["Satellite Repositories<br/>approver, costs, deployer,<br/>billing-separator, utils"]
        LZA["ndx-try-aws-lza<br/><b>Organization Config</b><br/>OUs, accounts, SCPs"]
        SCP["ndx-try-aws-scp<br/><b>Cost Defense</b><br/>Terraform SCPs, budgets"]
        TF["ndx-try-aws-terraform<br/><b>Org Utilities</b><br/>State bucket, billing access"]
    end

    OPT1 -.->|"functionality lives in"| ISB_CORE
    OPT2 -.->|"functionality lives in"| ISB_SAT
    OPT3 -.->|"functionality lives in"| LZA
    OPT3 -.->|"functionality lives in"| SCP

    style OPT1 fill:#fdd,stroke:#c00
    style OPT2 fill:#fdd,stroke:#c00
    style OPT3 fill:#fdd,stroke:#c00
Loading

Evidence from Cross-References

The ndx-try-aws-terraform README explicitly references this repository:

This repo does not contain Innovation Sandbox (ISB) files. ISB files are found in ndx-try-aws-isb.

This suggests ndx-try-aws-isb was originally intended to house ISB-specific configuration. However, the ISB implementation was ultimately deployed directly from the upstream innovation-sandbox-on-aws fork, with NDX-specific extensions handled by the satellite repositories (approver, costs, deployer, billing-separator) and organizational configuration managed by ndx-try-aws-lza and ndx-try-aws-scp.

License Context

The MIT License is dated 2025 and attributed to the "Central Digital and Data Office" (CDDO), consistent with the other NDX:Try repositories. The .gitignore follows a standard Node.js template, suggesting the original intent may have been a Node.js/TypeScript CDK project.

Current State

Attribute Status
Source code None
Infrastructure definitions None
Documentation None
GitHub Actions workflows None
Dependencies None
Test suite None
Last substantive commit Initial repository creation
Active development No

Where ISB Functionality Actually Lives

The Innovation Sandbox platform is distributed across multiple repositories, none of which is ndx-try-aws-isb:

Repository Function Relationship
innovation-sandbox-on-aws ISB Core platform (CDK + CloudFormation) The actual ISB solution
innovation-sandbox-on-aws-approver Automated lease approval (19-rule scoring engine) Satellite service
innovation-sandbox-on-aws-costs Post-lease cost collection Satellite service
innovation-sandbox-on-aws-deployer Scenario deployment to sandbox accounts Satellite service
innovation-sandbox-on-aws-billing-seperator 72-hour billing cooldown (temporary workaround) Satellite service
innovation-sandbox-on-aws-utils Pool account creation scripts Utility
ndx-try-aws-lza AWS organization structure and ISB OUs Organization config
ndx-try-aws-scp Cost defense SCPs for sandbox accounts Cost controls

Recommendation

This repository should be considered for archival to reduce confusion and maintenance overhead. No active code or configuration depends on it, and the README in ndx-try-aws-terraform cross-references it misleadingly as the home for ISB files.

If archiving:

  1. Archive the repository via GitHub settings
  2. Update the ndx-try-aws-terraform README to point to innovation-sandbox-on-aws instead
  3. Add an archived notice to the repository description

If retaining for future use:

  1. Add a README explaining the intended purpose and current empty state
  2. Document which specific ISB customizations would be housed here
  3. Link to the actual ISB implementation repositories

Related Documentation

Source Files Referenced

File Path Purpose
repos/ndx-try-aws-isb/.gitignore Standard Node.js .gitignore
repos/ndx-try-aws-isb/LICENSE MIT License, CDDO 2025
repos/ndx-try-aws-terraform/README.md Cross-reference to this repository

Generated from source analysis. See 00-repo-inventory.md for full inventory.