Skip to content

Commit 49e4834

Browse files
committed
Updated documentation
1 parent bcd514b commit 49e4834

1 file changed

Lines changed: 22 additions & 8 deletions

File tree

README.md

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,25 @@ Not every user who pulls code from your private codeartifact repository needs AW
1010

1111
## Features:
1212

13-
Although I haven't been able to test them all (mostly because I don't use the languages), the proxy should support the following artifact types (replace `artifacts.example.com` with your deployed proxy hostname)
13+
Although I haven't been able to test them all, the proxy should support the following artifact types (replace `artifacts.example.com` with your deployed proxy hostname).
1414

1515
| Repository Type | Tested | URL |
1616
| --------------- | ------ | ------------------------------------- |
1717
| Pypi | Yes | https://artifacts.example.com/simple/ |
18-
| NPM | Yes | https://artifacts.example.com/ |
18+
| NPM | No | https://artifacts.example.com/ |
1919
| Maven | No | https://artifacts.example.com/ |
2020
| Nuget | No | https://artifacts.example.com/ |
2121

22-
Currently we only support choosing a single repository at launch, athough maybe in the future I will look at auto-resovling the request and figure out which repository to use based on the useragent. This should simplify setup.
22+
Currently we only support choosing a single repository at launch, athough maybe in the future I will look at automatically figure out which repository to use based on the useragent. This should simplify setup.
23+
24+
### Known Issues
25+
26+
NPM support doesn't seem to be providing the correct results, it will connect to the proxy fine but respond with the CodeArtifact URL (which can't be access):
27+
28+
```
29+
root ➜ /workspaces/aws-codeartifact-proxy/test (master ✗) $ npm view --registry http://localhost:8080 aws-cdk dist.tarball
30+
https://sktansandbox-1234567890.d.codeartifact.ap-southeast-2.amazonaws.com:443/npm/sandbox/aws-cdk/-/aws-cdk-2.19.0.tgz
31+
```
2332

2433
## How to Use?
2534

@@ -29,11 +38,16 @@ You can run this in three easy ways.
2938
2. Use the container `sktan/aws-codeartifact-proxy` and run it on any capable host (AWS ECS, AWS EC2, Linux / Windows VM)
3039
3. Use the pre-built CDK template found in the `cdk` directory and deploy it to your environment (requires Python)
3140

32-
By default, the proxy will choose to use the Pypi as it's type. If you would like to use a separate registry type, set your `CODEARTIFACT_TYPE` environment variable to one of the following:
33-
- pypi
34-
- npm
35-
- maven
36-
- nuget
41+
Configuration is done via Environment Variables:
42+
43+
| Environment Variable | Required? | Description |
44+
| -------------------- | ---------- | ----------------------- |
45+
| CODEARTIFACT_REPO | Yes | Your CodeArtifact Repository Name (e.g. sandbox) |
46+
| CODEARTIFACT_DOMAIN | Yes | Your CodeArtifact Domain (e.g. sktansandbox) |
47+
| CODEARTIFACT_TYPE | No | Use one of the following: pypi, npm, maven, nuget |
48+
| CODEARTIFACT_OWNER | No | The AWS Account Id of the CodeArtifact Owner (if it's your own account, it can be empty) |
49+
50+
By default, the proxy will choose to use the Pypi as it's type.
3751

3852
Once you have started the proxy with valid AWS credentials (this uses the [default credential provider chain](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html#specifying-credentials)), you should receive similar output to this:
3953

0 commit comments

Comments
 (0)