{"id":22591511,"url":"https://github.com/netsells/cli","last_synced_at":"2025-08-20T04:26:11.675Z","repository":{"id":37581342,"uuid":"263092911","full_name":"netsells/cli","owner":"netsells","description":"A global CLI tool that contains functionality for all edges of development","archived":false,"fork":false,"pushed_at":"2024-09-23T13:26:47.000Z","size":307,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-02T18:51:56.322Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netsells.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-11T16:09:33.000Z","updated_at":"2024-12-06T12:26:09.000Z","dependencies_parsed_at":"2022-07-12T16:24:52.195Z","dependency_job_id":null,"html_url":"https://github.com/netsells/cli","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netsells%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netsells%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netsells%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netsells%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netsells","download_url":"https://codeload.github.com/netsells/cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246078411,"owners_count":20720148,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-08T09:12:57.065Z","updated_at":"2025-03-28T18:25:58.357Z","avatar_url":"https://github.com/netsells.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Netsells CLI\n\nThe Netsells Command Line Interface (CLI).\n\n## Table of Contents\n- [Installation](#installation)\n- [Documentation](#documentation)\n\n## Installation\n\nRun the following commands to download and install. `/usr/local/bin` should be in your `$PATH` in order to call `netsells` anywhere.\n\n```bash\ncurl -L -o netsells.phar https://github.com/netsells/cli/releases/latest/download/netsells.phar\nsudo mv netsells.phar /usr/local/bin/netsells\nchmod +x /usr/local/bin/netsells\nnetsells --version\n```\n\n### Usage\n\n```\n _   _      _            _ _        _____ _      _____\n| \\ | |    | |          | | |      / ____| |    |_   _|\n|  \\| | ___| |_ ___  ___| | |___  | |    | |      | |\n| . ` |/ _ \\ __/ __|/ _ \\ | / __| | |    | |      | |\n| |\\  |  __/ |_\\__ \\  __/ | \\__ \\ | |____| |____ _| |_\n|_| \\_|\\___|\\__|___/\\___|_|_|___/  \\_____|______|_____|\n\n\n  USAGE: netsells \u003ccommand\u003e [options] [arguments]\n\n  aws:ec2:list             List the instances available\n  aws:ssm:connect          Connect to an server via SSH (Use --tunnel to establish an SSH tunnel)\n  aws:assume-role          Assumes a role for a particular client\n  \n  aws:ecs:manage-env       Edits env variables stored in s3 for a client's ECS setup\n  \n  docker:aws:deploy-update Updates task definition and service\n  docker:aws:login         Logs into docker via the AWS account\n  docker:aws:push          Pushes docker-compose created images to ECR\n  docker:build             Builds docker-compose ready for prod\n```\n\n## Netsells File Reference\n\nThe CLI will look for configuration in the arguments/options supplied via the command line, falling back to the Netsells file. This should be placed at the root of your project and called `.netsells.yml`.\n\nBelow is a feature complete file to be used as reference:\n\n```yaml\ndocker:\n    services:\n        - web\n        - php\n    aws:\n        region: eu-west-2\n        ecs:\n            cluster: traefik\n            service: netsells-api\n            task-definition: netsells-api\n```\n\n## Command Reference\n\n* [aws:ec2:list](#awsec2list) - List the instances available\n* [aws:ssm:connect](#awsssmconnect) - Connect to a server via SSH (Use --tunnel to establish an SSH tunnel)\n* [aws:manage-env](#awsmanageenv) - Edit the .env file(s) used to configure ECS\n\n### aws:ec2:list\n\n```\nnetsells aws:ec2:list\n```\n\nReturns a list of ec2 instances on the AWS account\n\n**Available Arguments**\n* `--aws-profile=` - Override the AWS profile to use\n\n### aws:ssm:connect\n\n```\nnetsells aws:ssm:connect\n```\n\nEstablishes a command to a server over SSH. This command first generates a temporary SSH key, sends it to the server via SSM SendCommand feature which then allows 15 seconds for the SSH client to connect via the SSM session.\n\nIf you don't supply any options, you will be asked for them. `--tunnel` is required to establish an SSH tunnel (typically used for MySQL).\n\n**Available Arguments**\n* `--aws-profile=` - The name of the AWS profile to use\n* `--instance-id=` - The instance ID to connect to\n* `--username=` - The username connect with\n* `--tunnel` - Sets up an SSH tunnel. Required to initiate a tunnel connection\n* `--tunnel-remote-server=` - The SSH tunnel remote server\n* `--tunnel-remote-port=` - The SSH tunnel remote port\n* `--tunnel-local-port=` - The SSH tunnel local port\n* `--aws-profile=` - Override the AWS profile to use\n\n### aws:ecs:manage-env\n\n```\nnetsells aws:ecs:manage-env\n```\n\nEnables editing of .env files stored in S3 for a client to facilitate ECS configuration.\n\nThis will normally be run from the `aws:assume-role` command prompt, but can be run outside of that if you are authenticated as an AWS user with appropriate permissions to the S3 bucket.\n\nThe editor is configured to use vi (the preferred editor for real geeks), but you can change this by setting the `EDITOR` enviroment variable to the full path of your preferred editor.\n\nIf run from the `aws:assume-role` command prompt, the S3 bucket for the .env files will be already selected from the accounts.json file. However, this can be supplied using the appropriate argument.\n\n**Available Arguments**\n* `--s3-bucket-name` - The name of the S3 bucket holding the .env files\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetsells%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetsells%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetsells%2Fcli/lists"}